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This publication describes the use and general function 
of the System Monitor of the ibm 7090/7094 ibsys 
Operating System, version 13 (7090-PR-130). The ibsys 
Operating System consists of a number of commercial 
and scientific programming aids operating under over- 
all control and direction of the System Monitor ( 7090- 
SV-918 ) . It is designed to process sequentially a variety 
of unrelated jobs with little or no operator intervention. 
The System Monitor includes the System Supervisor, 
the System Nucleus, the Input/Output Executor, the 
System Core-Storage Dump Program, and the System 
Editor. In general, the "Introduction" of this publi- 
cation and the sections describing the System Super- 
visor and the System Core-Storage Dump Program are 
directed primarily to the applications programmer. 
The remaining sections are directed to the systems 
programmer. 










Preface 



This publication describes the use and general function 
of the System Monitor of the ibm 7090/7094 ibsys 
Operating System (Version 13) and provides informa- 
tion for maintaining the system. The ibsys Operating 
System may be considered an integral part of the ibm 
7090/7094 Data Processing System. It consists of a 
comprehensive set of programming aids operating as 
subsystems under a master System Monitor. 

The System Monitor described in this publication 
encompasses the System Supervisor, the System Nu- 
cleus, the Input/Output Executor, the System Core- 
Storage Dump Program, and the System Editor. The 
subsystems operating under the System Monitor are de- 
scribed in separate publications. These publications 
are referred to in the "Introduction" section of this 
manual and are listed in Figure 2 in the "System 
Supervisor" section. Instructions for the operator of 
the system are provided in a separate publication 
entitled IBM 7090/7094 IBSYS Operating System: 
Operators Guide, Form C28-6355. 

This publication on the System Monitor is divided 
into seven major sections. The first three sections, "In- 
troduction," "System Supervisor," and "System Core- 



Storage Dump Program," are directed primarily to 
the applications programmer. The remaining sections 
are directed primarily to the systems programmer. The 
systems programmer is an experienced programmer 
who is assigned to place the ibsys Operating System 
into operation, modify it according to the special re- 
quirements of his installation, maintain it, and ensure 
adequate control over its content and use. 

All of the System Monitor control cards that might 
be used by the applications programmer in program- 
ming a job are described in the section on the System 
Supervisor. However, very few of the cards are actually 
required for most jobs. Therefore, these cards are 
described first, for the benefit of the reader who is 
only interested in the control cards required to run an 
average job such as a Fortran compilation and execu- 
tion. The control cards described in the remainder of 
the section are primarily of interest to the more experi- 
enced programmer, the systems programmer, and the 
operator. 

The reader of this manual is assumed to be familiar 
with the contents of the ibm reference manual IBM 
7094 Data Processing System, Form A22-6703. 
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Introduction 



Function 

The 7090/7094 ibsys Operating System consists of a 
comprehensive set of commercial and scientific pro- 
gramming aids operating as subsystems, under ex- 
ecutive control and coordination of a System Monitor. 
The Monitor, by coordinating the operation of the 
subsystems, enables a series of unrelated jobs to be 
processed with little or no operator intervention. By 
reducing the degree of human participation in the 
mechanics of data processing, the Operating System 
ensures that jobs are processed faster, more efficiently, 
and are less subject to human error. As a result, turn- 
around time, the interval between the time a pro- 
grammer submits a job for processing and the time 
he receives results, is significantly reduced. 



Organization 

System Monitor 

The general organization of the System Monitor, as 
well as its general relation to the subsystems operating 
under it, is illustrated in Figure 1. The System Monitor 
consists of: 

1. The System Supervisor, whose primary function 
is to control and coordinate the processing of jobs by 
passing control from one subsystem to another. 

2. The System Nucleus, which remains in core stor- 
age at all times and provides common facilities for 
intercommunication and control among the subsystems 
and between the System Monitor and the subsystems. 

3. The Input/Output Executor, which normally re- 
mains in core storage to coordinate and control input/ 
output and other trapping operations. 

4. The System Core-Storage Dump Program, which 
may be used to facilitate the testing and analysis of 
any program executed under control of the Operating 
System. 

5. The System Editor, which provides the systems 
programmer with facilities for modifying and main- 
taining the System Monitor and the subsystems 
operating under it. 

The System Monitor may also contain an installation 
accounting routine tailored to the specific requirements 
of the installation. 

The subsystems operating under the System Monitor 
(Figure 1) provide the programmer with a variety of 
programming facilities which he may use singly or in 



combination to process a particular job. Each of these 
subsystems is described briefly below. 

IBJOB Processor 

The ibjob Processor is the major subsystem of the 
ibsys Operating System. It is a highly integrated 
processor which consists of the following: 

The Processor Monitor ( IBJOB ) 
The FORTRAN IV Compiler ( IBFTC) 
The COBOL Compiler (IBCBC) 

The Assembler— The Macro Assembly Program ( IBMAP ) 
A relocatable loader-The Loader ( IBLDR ) 
Preassembled subroutines to be used, if required by the ob- 
ject program— The Subroutine Library (IBLIB) 
The Debugging Package (IBDBL and IBDBC) 

Just as the System Monitor (ibsys) provides over-all 
control for the subsystems under it, the ibjob Processor 
Monitor provides control over the ibjob components. 
The compilers and the assembler under the control of 
the Processor Monitor are used to translate source 
programs, written in higher-level programming lan- 
guages, into machine language object programs. The 
Debugging Package provides the programmer with a 
means of obtaining highly selective dynamic dumps of 
any core storage locations and any registers at selected 
points in his program. The Subroutine Library in- 
cludes a complete Input/Output Control System. The 
Loader loads object programs in preparation for exe- 
cution, and also loads the portions of iocs that are 
required by that object program. 

The ibjob Processor and its use are described in 
detail in the publication IBM 7090/7094 IBSYS Oper- 
ating System: IBJOB Processor, Form C28-6389. 

FORTRAN II Processor 

The fobtran ii Processor can be used in either of two 
modes, the Fortran mode or the ibsfap mode. 

In the Fortran mode, the Fortran ii Processor can 
be used to compile, assemble, load, and execute source 
programs written in Fortran ii language. It can also 
assemble, load, and execute programs written in For- 
tran ii Assembly Program (fap) language and load 
and execute previously assembled object programs. 
Facilities are provided for combining program seg- 
ments written in Fortran ii and fap languages with 
previously assembled segments to form a single ex- 
ecutable object program. Facilities are also provided 
for chaining core storage loads so that executed por- 
tions of a program may be overlaid with portions yet 
to be executed. 
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Figure 1. ibm 7090/7094 ibsys Operating System 



In the ibsfap mode, the Fortran ii Processor can 
be used to assemble, but not load and execute, pro- 
grams written in fap language. An assembled object 
program can be loaded and executed under control 
of the Input/Output Control System or the Fortran 
mode of the Fortran ii Processor. The ibsfap mode 
of the Fortran ii Processor can also be used to up- 
date symbolic tapes by changing, deleting, or adding 
instructions. 

The Fortran ii Processor and its use are described 
in detail in the publication IBM 7090/7094 Program- 
ming Systems: FORTRAN II Operations, Form C28- 
6066. 

The Fortran ii Assembly Program and its use are 
described in the publication IBM 7090/7094 Pro- 
gramming Systems: FORTRAN II Assembly Program 
(FAP), Form C28-6235. 

Input/Output Control System 

The Input/Output Control System (Full iocs) provides 
input/output control for programs assembled by the 
Fortran ii Processor. It relieves the programmer of 
the task of writing complex input/output routines by 
automatically controlling the blocking and unblocking 
of data records, the overlapping of processing with 
input and output, and the preparation and checking 
of labels. Only those portions of iocs actually required 
are loaded with the assembled object program. 

iocs and its use are described in detail in the pub- 
lication IBM 7090/7094 IBSYS Operating System: 
Input/Output Control System, Form C28-6345. 

Symbolic Update Program 

The Symbolic Update Program can be used to modify 
symbolic tapes by changing, deleting, or adding sym- 
bolic card images and producing new symbolic tapes. 
This subsystem enables programmers to update pro- 
grams already on tape in the map, Fortran iv, or 
cobol languages. It can also be used to maintain 
multireel input and output tapes, extract card images 
from an input tape, space tape, and check the sequence 
of serialization of card images on tape. 

The Symbolic Update Program and its use are de- 
scribed in the publication IBM 7090/7094 IBSYS 
Operating System: Symbolic Update Program, Form 
C28-6386. 

Restart Program 

Unlike the other subsystems operating under the 
System Monitor, the Restart Program is used exclu- 
sively by the operator of the system. It is designed to 
enable the operator to restart an interrupted program 
using a checkpoint record recorded by iocs before the 
interruption occurred. 



The use of the Restart Program is described in the 
publication IBM 7090/7094 IBSYS Operating System: 
Operators Guide, Form C28-6355. 

Commercial Translator Processor 

The Commercial Translator Processor may be used to 
compile, assemble, load, and execute programs written 
in the ibm Commercial Translator language. 

The Commercial Translator Processor and its use 
are described in the publication IBM 709/7090 Com- 
mercial Translator Processor, Form J28-6169. 

Generalized Sorting System 

The Generalized Sorting System can be used to sort 
fixed-length or variable-length records, written in either 
binary or decimal mode. The control fields of the rec- 
ords may be signed or unsigned. The records can be 
sorted in ascending or descending order, using either 
the commercial or scientific collating sequence. 

The Generalized Sorting System and its use are 
described in the publication IBM 7090/7094 Gen- 
eralized Sorting System: 7090/7094 Sort, Form C28- 
6365. 

9PAC Processor 

The 9pac Processor can be used to establish and main- 
tain data files and to generate reports on the data in 
the files. 

The 9pac Processor and its use are described in the 
following publications: 

IBM 7090 Programming Systems, Share 7090 9PAC 
Part 1: Introduction and General Principles, Form 

J28-6166 
Part 2: The File Processor, Form J28-6167 
Part 3: The Reports Generator, Form J28-6168 

Utilities 

The Utilities consist of a tape dump routine for 729 
Magnetic Tape Units and 7340 Hypertape Drives and 
of the following for 1301/2302 Disk Storage and 7320 
Drum Storage: format track generation, home address 
and record address identification, load disk/drum, dump 
disk/drum, dump 2302 disk platter, restore disk/drum, 
and clear disk/drum. 

The utilities and their use are described in the 
following publication: 

IBM 7090/7094 IBSYS Operating System: Utilities, 
Form C28-6364 

User Programs 

In addition to the subsystems described above, the 
user of the ibsys Operating System may design pro- 
grams and incorporate them as subsystems operating 
under the System Monitor. Conversely, the user may 
remove subsystems or portions of subsystems that are 
not required at his installation. 



Introduction 



Application 

In programming a job, the programmer may employ 
any logical combination of the subsystems operating 
under the System Monitor. The programmer, in effect, 
controls and directs the processing of his job from his 
desk by inserting the proper control cards in his job 
deck. Before a particular job is processed, it may be 
combined with other jobs to form a single input file 
of unrelated jobs. The input file of jobs can then be 
processed by the Operating System without costly 
setup delays between jobs or job segments while the 
data processing system lies idle. 

The operator of the system, for the most part, per- 
forms relatively routine functions, such as loading or 
unloading tape reels. Usually he is told what to do 
and when by means of an on-line printout from the 
Operating System. If the Operating System, owing to 
a programmer error, cannot complete a job or job seg- 
ment, it automatically skips to the next job or job 
segment without intervention by the operator. How- 
ever, the operator can, if he chooses, interrupt the 
Operating System at the end of any job. By means 
of control cards, he can then direct the Operating 
System to perform any one of several operations, for 
example, to restart at the beginning of another job 
on the input file. 

If an error occurs during the execution of an object 
program, the operator, the Operating System, or the 
object program itself can call for a post-mortem dump 
of any part or all of the core storage (to facilitate 
analysis of the error) followed by an automatic skip 
to the next job segment. An object program can also, 
at any point in the program, call for a snap dump of 
any part or all of core storage. At the completion of 
the snap dump, the contents of core storage are re- 
stored and the execution of the object program is re- 
sumed. Any one of six formats can be specified for a 
core storage dump. ( See Figure 6 in the section "System 
Core-Storage Dump Program.") 

When an input file of jobs is completed, the Oper- 
ating System stops after providing the operator with 
information on the status of the system input and 
output files. Then, by the use of control cards, the 
operator can direct the Operating System to perform 
any one of a number of operations. For example, he 
may direct it to restart at the beginning of a new 
input file or to rewind and unload the input and out- 
put files. 



System Unit Functions 

To ensure continuous job processing and proper co- 
ordination between subsystems, the System Monitor 
provides a logical framework for assigning input/out- 



put units to specific functions and for keeping track 
of the exact status of all units at all times. Some units 
are assigned system unit functions, that is, they are 
assigned specific functions required by the nature of 
the Operating System and may be used in that capacity 
by the System Monitor and each of the subsystems 
operating under it. For example, at least one unit is 
used as a system input file on which jobs are stacked 
so that they can be processed continuously by the 
System Monitor and the various subsystems. Any units 
not assigned to system unit functions are available for 
use by the programmer, provided they are not log- 
ically detached from the Operating System. Appendix 
F contains charts showing which of the system unit 
functions are required by the Operating System and 
by each of its subsystems, as well as the types of de- 
vices that may be assigned to these functions. 

The following are the system unit functions to which 
units may be assigned. Some functions may not have 
units assigned to them, depending on the require- 
ments of a particular installation. 

Information as to which types of input/output de- 
vices can be assigned to specific system functions for 
a particular subsystem may be found in the IBM 7090/ 
7094 IBSYS Operating System: Operators Guide, 
Form C28-6355, under "Use of Input/Output Units." 

System Input 

A System Input Unit is required by every installation 
for use as a common job input file. Normally, the input 
file tape is prepared off-line on an auxiliary 1401 Data 
Processing System. The input file may contain System 
Monitor and subsystem control cards, symbolic source 
programs, binary object programs, and data. 

System Output 

A System Output Unit is required by every installa- 
tion for use as a common output print file. The output 
file will contain messages from the Operating System 
and may contain source program listings, assembly 
listings, core storage dump listings, and output data. 

System Peripheral Punch 

A unit must be assigned as a System Peripheral Punch 
Unit. The peripheral punch file may be processed off- 
line to produce binary object program card decks. 

The same unit can be assigned as both the System 
Output Unit and the System Peripheral Punch Unit. 
However, when this dual assignment is used, Fortran 
ii programs cannot be executed. In addition, some 
output may be lost when the combined unit is back- 
spaced to suppress punched output due to errors in 
relocatable fap or ibsfap assemblies. 



System Library 

At least one unit must be assigned as a System Library 
Unit on which the- ibsys Operating System itself is re- 
corded. Up to four units may be assigned as library 
units. When magnetic tape units are used, the 
Operating System may be duplicated on two System 
Library Tapes which can be referred to alternately 
in order to reduce delays in processing while the 
library tape is being rewound. The Operating System 
can also be split between two or more library units 
in order to reduce the time required to gain access to 
particular parts of the Operating System. 

System Utility 

Four System Utility Units are required by every in- 
stallation for general use by the System Monitor and 
the subsystems operating under it. Up to five addi- 
tional units may be assigned to System Utility functions 
for object program use. The required System Utility 
Units may also be used by object programs. However, 
the programmer should avoid assigning any files that 
are to be retained, to System Utility Units that will be 
used by the Operating System during the job. 

A unit assigned as a System Utility Unit may be 
simultaneously assigned as a System Checkpoint Unit. 

System Checkpoint 

A unit may be assigned as a System Checkpoint Unit 
on which checkpoint records are recorded under iocs 
control. The same unit may also be assigned as a 
System Utility Unit. 

System Printer 

A 716 Printer is assigned as the System Printer. It is 
used by the Operating System to record messages to 
the operator. 

System Card Reader 

A 711 Card Reader is assigned as the System Card 
Reader. Normally, the card reader is used by the 
operator for inserting control cards that direct the 
Operating System. The card reader may also be used 
as a substitute input unit for processing small job files. 

System Card Punch 

A 721 Card Punch may be assigned as the System 
Card Punch. The punch may be used to punch con- 
trol cards for use by the operator, or it may be used 
as a substitute output unit. 

Alternate Units 

A second unit may be assigned to the system input, 
output, peripheral punch, or checkpoint functions. If 
a second unit is assigned, it serves as an alternate unit 
to eliminate delays due to reel switching. When an 
end of tape is reached on one unit an automatic switch 
can be made to the alternate unit. In the distributed 



version of the Operating System, the same 729 Mag- 
netic Tape Unit is assigned to a system utility function 
(sysut4) and to the alternate peripheral punch function 
(syspp2). Therefore, if automatic reel switching is 
expected for the peripheral punch, different units 
should be assigned to these functions. 

Machine Requirements 

The following minimum machine configuration is re- 
quired for use of the 7090/7094 ibsys Operating 
System: 

1. An ibm 7090/7094 Data Processing System. 

2. Three ibm 729 Magnetic Tape Units or ibm 7340 
Hypertape Drives for assignment as System Input, 
Output, and Peripheral Punch Units. A single unit may 
be assigned as a combined System Output and Periph- 
eral Punch Unit (but note restrictions stated under 
"System Peripheral Punch"). If this is done, the extra 
unit may be assigned as a second System Library Unit. 

3. Five units; one for assignment as a System Library 
Unit and four for assignment as System Utility Units. 
These units may be any combination of ibm 729 Mag- 
netic Tape Units, 7340 Hypertape Drives, or selected 
cylinders of direct access storage units. (In the re- 
mainder of this publication, direct access storage, 
when used, will refer to both ibm 1301/2302 Disk 
Storage and ibm 7320 Drum Storage.) If more than 
one type of direct access storage unit is attached to the 
same 7909 data channel switch (interface) setting 
within a channel, the module numbers must be assigned 
in the following order: 

1301 modules <2302 modules <7320 modules 

4. One ibm 716 Printer for assignment as the System 
Printer. 

5. One ibm 711 Card Reader for assignment as the 
System Card Reader. 

The 1401/1460 peripheral input/output programs for 
the ibm 7090/7094 ibsys Operating System require an 
ibm 1401 Data Processing System with the following 
features : 

1. 4000 locations of core storage 

2. Advanced Programming feature 

3. High-Low-Equal Compare feature 

4. Sense Switch feature 

5. One ibm 729 or 7330 Magnetic Tape Unit 

6. One ibm 1402 Card Read Punch with the Read- 
Punch Release Feature and the Column Binary Feature 
(on 1401) or with the Binary Transfer and Bit Test 
Features (on 1460) 

7. One 1403 Printer with 132 print positions and 
the Print Control feature 

Additional information on the 1401/1460 peripheral 
input/output programs can be found in the publication 
IBM 7090/7094 IBSYS Operating System, Version 13: 
Operators Guide, Form C28-6355. 
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System Supervisor 



Function 

The primary function of the System Supervisor is to 
coordinate and supervise the processing of jobs by: 

1. Passing control from one subsystem to another. 

2. Restoring unit assignments between jobs. 

3. Controlling interruption by the operator. 

4. Skipping jobs or job segments when directed by 
a subsystem. 

In addition, the System Supervisor can be directed 
by control cards to perform a variety of other func- 
tions, such as changing unit assignments, manipulating 
tape units, and passing control to the System Editor. 
The System Supervisor is directed to perform its 
functions mainly by means of control cards which it 
reads from a system input file, interprets, and acts 
upon. 



Definition of Job and Job Segment 

Of the many control cards that are recognized by 
the System Supervisor, the key cards in controlling 
the continuous processing of jobs are the $job card, 
sexecute card, sibsys card, and $stop card. Each of 
these cards is recognized and acted upon by each of 
the subsystems operating under control of the System 
Supervisor, as well as by the System Supervisor. 

A job consists of all of the cards beginning with a 
$job card and ending with, but not including, the next 
$job card. Each job in a stack of jobs on an input file is 
considered to be entirely independent of any other job. 

A $job card may be followed by a $execute card, 
$ibsys card, or $ro card. If a $id card, which is an op- 
tional card used for intrajob accounting purposes, 
follows the $job card, it must itself be followed by 
either a sexecute or sibsys card. 

A job segment to be performed by the System 
Monitor consists of all cards beginning with a sibsys 
card and ending with, but not including, the next 
sexecute card, sjob card, or sstop card. 

A job segment to be performed by a subsystem con- 
sists of all cards beginning with a sexecute card and 
ending with, but not including, the next sexecute 
card, sibsys card, sjob card, or sstop card. The job 
segment may consist of one or more applications of 
the particular subsystem specified on the sexecute 
card. Any cards in the job segment that follow the 
sexecute card are read and interpreted by the sub- 
system specified on the sexecute card. They, therefore, 



must conform to the requirements of the specific sub- 
system. The publications describing the requirements 
for each subsystem are listed in Figure 2. 

Control Card Format 

The general format of the System Supervisor control 
cards follows: 

COLUMNS CONTENTS 

1 $ 

2-8 Control card name left-justified 

16-72 Variable field information (argument 1, 

argument 2,... .argument n) 

Columns 7 and 8 are not examined by the System 
Supervisor. 

Embedded blanks are not allowed within arguments, 
except for the sdate card. A comma separates argu- 
ments and a blank separates the last argument from 
comments. 

In this publication, the following conventions are 
used for variable field information: 

1. Lower-case letters indicate that a substitution 
must be made. 

2. Upper-case letters must be punched exactly as 
shown. 

3. Brackets [ ] contain an option that may be 
omitted or included by the user. 

4. Braces { } indicate that a choice of the con- 
tents is mandatory. 

5. A number over the first character of a field in- 
dicates the first card column of the field. 

Basic Control Cards 

In a typical installation, only the following System 
Supervisor control cards are normally required: 

$JOB 
$IBSYS 
$EXECUTE 
$STOP 

These cards are recognized by each of the subsys- 
tems and the System Editor as well as by the System 
Supervisor. Detailed descriptions of the cards follow. 

$JOB Card 

Format: 

1 16 

$JOB any text 

This card defines the beginning of a job. It causes 
a transfer to the installation accounting routine (if one 
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Subsystem Name 
Specified on 
$EXECUTE Card 


Full Name 

of 
Subsystem 


Publications Describing Subsystems 


IBJOB 


IBJOB Processor 


IBM 7090/7094 IBSYS Operating System: 
IBJOB Processor, Form C28-6389 


FORTRAN 


FORTRAN II 
Processor 
(FORTRAN Mode) 


IBM 7090/7094 Programming Systems: 
FORTRAN II Operations, Form C28-6066 


IBSFAP 


FORTRAN II 
Processor 
(IBSFAP Mode) 


IBM 7090/7094 Programming Systems: 
FORTRAN Assembly Program (FAP), 
Form C28-6235 


IOCS 


Input/Output 
Control System 


IBM 7090/7094 IBSYS Operating System: 
Input/Output Control System, Form C28-6345 


RESTART 


Restart Program 


IBM 7090/7094 IBSYS Operating System: 
Operator's Guide, Form C28-6355 


CT 


Commercial 

Translator 

Processor 


IBM 7090/7094 Commercial Translator 
Processor, Form J28-6169 


SORT 


Generalized 
Sorting System 


IBM 7090/7094 Generalized Sorting System: 
7090/7094 Sort, Form C28-6365 


9PAC 


9PAC 


IBM 7090 Programming Systems, Share 7090 9PAC 
Part 1 : Introduction and General Principals, 
Form J28-6166 

Part 2: The File Processor, Form J28-6167 
Part 3: The Reports Generator, Form J28-6168 


DK90UT 


Utilities 


IBM 7090/7094 IBSYS Operating System: Utilities 
Form C28-6364 


UPDATE 


Symbolic Update 
Program 


IBM 7090/7094 IBSYS Operating System: Symbolic 
Update Program, Form C28-6386 



EDITOR 



'System Editor 



Described in this publication 



*Although the System Editor is a part of the System Monitor itself, it 
acts like a subsystem in that it can be called by means of a $EX£CUTE card. 

Figure 2. Subsystems Operating Under Control of the System Monitor 



exists at the installation) and the restoration of any 
units that were reassigned or made unavailable during 
a previous job, with the exception of the following: 

1. Any unit that was logically detached from con- 
trol by the Operating System. 

2. Any unit that was assigned to a system unit 
function in place of a detached unit. 

3. Any unit that was assigned to a system input, 
system output, or system peripheral punch function. 

A unit originally assigned to a system input, system 
output, or system peripheral punch function is not 
restored because it may have been validly replaced by 
its alternate unit when an end of tape was encountered. 

When a $job card is read by a subsystem, the System 
Supervisor is called into core storage only if it is re- 
quired either to restore the status of a unit or to 
control a manually initiated between-jobs interrupt 
condition. 

The $job card is listed on both the System Printer 
and the System Output Unit. Columns 16 through 72 



are normally used to identify a job and may contain 
any combination of alphameric characters and blanks. 

$IB5YS Card 

Format: 

1 16 

$IBSYS 

When this card is read by a subsystem or by the 
System Editor, the System Supervisor is called into 
core storage and control is relinquished to it. The 
System Supervisor then reads and processes succeeding 
control cards until control is relinquished to a sub- 
system by means of a sexecute card or to the System 
Editor by means of a sexecute editor or sibedt card. 

$EXECUTE Card 

Format: 



$EXECUTE 



16 

subsystem name 
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This card defines the beginning of a job segment 
that is to be processed by the specified subsystem. If 
the $execute card is read by the System Supervisor, 
the System Supervisor positions the proper System 
Library Unit to the specified subsystem, reads in the 
first record of the subsystem, and relinquishes control 
to it. If the card is read by a subsystem other than the 
one specified, control, as well as the subsystem name, 
is passed to the System Supervisor, which in turn, 
reads in the first record of the specified subsystem and 
relinquishes control to it. If the card is read by the 
specified subsystem, the subsystem retains control and 
proceeds to process the job segment. 

The subsystem name consists of six or fewer bcd 
characters corresponding to a name in the System 
Name Table of the System Supervisor. The System 
Name Table indicates the arrangement of the partici- 
pating subsystems on the System Library Units and 
is used by the System Supervisor to locate a subsystem 
specified by a $execute card. 

Although the System Editor is an integral part of 
the System Monitor, it is recognized as a subsystem by 
the System Supervisor and can be called by a sexecute 
editor card as well as by the sibedt card. The name 
editor is placed in the ibsys System Name Table ( see 
"sexecute Card"), and the Editor respects the rules 
governing job-control communication. 

The names for the subsystems provided with the 
distributed versions of the ibsys Operating System 
are listed in Figure 2, together with the full name of 
each subsystem and the publication or publications 
describing it. 

$STOP Card 

Format: 

1 16 

$STOP 

This card is used to define the end of a stack of jobs. 
It is usually placed, by the operator or a job setup 
man, at the end of a stack of jobs on the system input 
file. When the card is read by a subsystem, the System 
Supervisor is called into core storage and alerted to 
the fact that the card was read. Upon recognition of 
the $stop card, the System Supervisor performs the 
following actions: 

1. Prints, on the System Printer, the physical unit 
assignment and tape position (record and file count) 
of the System Output Unit, the System Peripheral 
Punch Unit, and the System Input Unit followed by 
the message: 

END OF JOBS 

2. Writes a trailer label on the System Peripheral 
Punch Unit, if it is not at load point, and backspaces 
over the trailer label. 



3. If a srewind sysoui, sremove sysoui, or another 
sstop card was not read previously*, writes a trailer 
label on the System Output Unit and backspaces over 
the trailer label. 

4. Stops the machine with the System Card Reader 
temporarily assigned to the system input function. 

When start is pressed, the control cards, if any, in 
the card reader are read and processed by the System 
Supervisor until they are depleted. When the cards 
in the card reader are depleted, the System Supervisor 
proceeds to read control cards from the unit assigned 
as the System Input Unit. Therefore, when the ma- 
chine stops at the end of a stack of jobs, the operator 
may terminate job processing by using any of the 
System Supervisor control cards, such as the sendfile 
and $remove cards; or he may continue processing a 
new stack of jobs, either on the card reader or on the 
tape unit assigned as the System Input Unit. 

Typical Input Deck 

Figure 3 shows a composite system input deck con- 
taining several jobs. 

Control Cards Used Primarily by the 
Experienced Programmer and the Operator 

The control cards described in this section are mainly 
of interest to the experienced programmer and the 
operator. These control cards are recognized by the 
System Supervisor only and not by a subsystem. There- 
fore, they should be used only under the following 
conditions: 

1. At the beginning of an input file following an 
initial start. 

2. Following a sibsys card or other System Super- 
visor control cards, other than a $ibedt card, that fol- 
low an sibsys card. 

3. In the System Card Reader during a between- 
jobs or end-of-jobs interrupt. 

Initialization Control Cards 

$DATE Card 

Format: 

1 16 

$DATE mmddyy 

This card is normally used by the operator at the 
beginning of each day. The card causes the six charac- 
ters in columns 16 through 21 of the card to be stored 
in the sysdat word of the Communication Region of 
the System Nucleus. Although a subsystem may dis- 



♦After a SREWIND SYSOUI, $REMOVE SYSOUI, or SSTOP card is read 
and processed, further use of the System Output Unit by the System 
Supervisor is suspended until a $JOB card is read or the System Super- 
visor is called into core storage again by a $IBSYS card or by a sub- 
system. 
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Fourth Job 



z 



$EXECUTE IBSFAP 



Fourth Job Segment 
(9PAC) 



|$JOB FAP JOB 25 



Second Job Segment^ 
(System Monitor) 



First Job 
Segment 
(IBJOB) 



$EXECUTE IBJOB 
$JOBWEEKLY REPORf 





(FAP Source Deck) Y 



Second Job 



Figure 3. Composite System Input Deck 



play or otherwise use the sysdat word, it should not 
be modified by the subsystem. If an installation has 
an interval timer that produces the current date, the 
date should be stored in the form specified for the 
$date card, where: 

mm= Month (01 to 12) 

dd = Day (01 to 31) 

yy = Year (00 to 99) 

$RESET Card 

Format: 

1 16 

$RESET 

This card causes the assignment of a unit to any 
system unit function, which currently has no unit as- 
signed, but had a unit assigned at initial start. The 



original unit is reassigned to the function if the unit 
is not reserved or detached. If it is reserved or de- 
tached, a unit from a unit availability chain in the 
System Nucleus is assigned. 

The sreset card may be used following a sibsys card 
and preceding a $execute card to ensure that all 
system utility functions have units assigned before the 
start of a new job segment. 

$RE5TORE Card 

Format: 

1 16 

$RESTORE 

This card causes the restoration of the System Super- 
visor and the regeneration of the System Nucleus as 
specified by assembly parameters. 
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The srestore card causes the System Monitor to be 
called into core storage from the System Library 
Unit, giving the same effect as an initial start, except 
that the tape positions and the sysdat word in 
the Nucleus are not disturbed. The effect of all 
previous control cards is canceled, except that the 
srestore card does not effect the source of input as 
specified by scards or $tape cards. However, the unit 
assigned as the System Card Reader or the System 
Input Unit may change as a result of the srestore card 
because of a different unit having been assigned 
previously by $attach, sas, or sswitch cards. 



$RESTART Card 

Format: 

1 
$RESTART 



16 
L I MATCH \ J 



This card is used in the System Card Reader to re- 
start at the beginning of a particular job on the 
System Input Tape. It may be used by the operator in 
performing an initial start procedure, a between-jobs 
interrupt procedure, an end-of-jobs procedure, or a 
procedure following the detection of an invalid System 
Monitor control card. The exact use of the srestart 
card in performing each of these procedures is de- 
scribed in the publication IBM 7090/7094 1BSYS 
Operating System: Operator's Guide, Form C28-6355. 

If the variable field of the srestart card is +n', the 
System Supervisor will restart at the beginning Of the 
nth job following the last completed or last partially 
completed job. For example, if n is 1 and the card 
is used during an interruption between jobs on the 
System Input Tape, the System Supervisor restarts 
at the beginning of the next job on the input tape as 
though no srestart card was processed. If the variable 
field is — n, the System Supervisor will restart at the 
nth job preceding the last completed or partially com- 
pleted job. The value n may range from to 9999. If 
n is or blank, the System Supervisor will restart at 
the beginning of the last completed or partially com- 
pleted job. 

When the word match is specified in the variable 
field of the srestart card, the card should be followed 
by a $job card corresponding to a sjob card on the 
System Input Tape. The System Supervisor will read 
the sjob card following the srestart match card, 
rewind the System Input Tape, search the input file 
for a job with a matching sjob card and, if found, 
restart at the beginning of the job. If a sstop card is 
encountered before a matching job card, the System 
Input Tape will be repositioned to the end of the last 
completed job and the restart request will be ignored. 

Note: Only nonblank characters in the variable field 
will be compared when matching job cards. 



Miscellaneous Control Cards 

$ID Card 

Format: 

1 7 

$ID any text 

This card is used for intrajob accounting purposes 
at installations that employ an installation accounting 
routine. The card causes a transfer of control to the 
installation accounting routine if one exists. Upon com- 
pletion of the accounting routine, the next card in the 
system input file is read and processed. Columns 7 
through 72 of the card may contain any combination 
of alphameric characters and blanks. 

The distributed version of the Operating System 
does not contain an installation accounting routine. 
Therefore, no action occurs when the card is read 
other than the listing of the card on the System Printer 
and the System Output Unit. 

The exact use and placement of the sid card will 
depend upon the accounting practices and regulations 
in force at a particular installation. 

$* Card 

Format: 

1 3 

$* any text 

This card is listed on the System Printer and System 
Output Unit. No further action occurs. Columns 3 
through 72 of the card may contain any combination 
of alphameric characters and blanks. 

$PAUSE Card 

Format: 

1 16 

$PAUSE instructions to operator 

This card causes the machine to stop after the card 
and the following message is listed on the System 
Printer: 

OPER. ACTION PAUSE 

When start is pressed, the processing of cards on 
the system input file is resumed. Columns 16 through 
72 of the card may contain any combination of alpha- 
meric characters and blanks. 

This card provides the programmer with a means 
of temporarily interrupting processing to enable the 
operator to perform a specific task, such as file pro- 
tecting a reel of tape. Therefore, when the card is 
used, it should contain an explicit message to the 
operator so that processing can continue without fur- 
ther delay. 

$UST Card 

Format: 

1 
$LIST 



16 



14 



This card causes all control cards to be listed on the 
System Printer as well as on the System Output Unit. 
Normally, all cards are listed on the System Output 
Unit and only the $job, $id, $*, spause, srestart, sstop, 
scards, $tape, $list, and sunlist cards are listed on 
the System Printer. 

$UNUST Card 

Format: 

1 16: 

$UNLIST 

This card negates the effect of the slist card by 
causing only the $job, $id, $*, $pause, srestart, $stop, 
scards, $tape, $list, and $unlist cards to be listed on 
the System Printer. The normal mode is unlist, unless 
the control cards are read by the System Card Reader. 

$UNITS Card 

Format: 

1 16 

$UNITS 

This card causes all systems unit function names, 
physical unit assignments, and assigned densities to 
be listed on the System Output Unit. If a direct 
access storage unit is assigned to a system unit func- 
tion, the HA2 home address identifier and the cylinder 
limits for the function are included. 

This information is also printed on the System 
Printer if the $units card was read from the System 
Card Reader or if a $list card is in effect. 

The printout caused by the sunits card may be used 
to verify all unit assignment operations. 

$IBEDT Card 

Format: 

1 16 

$IBEDT 

Upon recognizing this card, the System Supervisor 
calls the System Editor into core storage from a Sys- 
tem Library Unit and relinquishes control to it. The 
same effect may be accomplished by a sexecute card 
with the name editor specified in the variable field. The 
control cards that are recognized by the System Editor 
are described in the section "System Editor." 

Unit Assignment Control Cards 

The purpose of the unit assignment control cards is 
twofold. First, they provide a means whereby an 
installation may indicate changes in machine input/ 
output capabilities to the System Monitor and the 
subsystems under its control. Second, they provide a 
means for changing input/output unit assignments 
within a job. 



The unit assignment control cards fall into two 
categories: those which define the physical avaliability 
(attachment or detachment) of an input/output unit 
and those which reassign input/output units to logical 
system unit functions. Input/output units are initially 
assigned by assembly parameters when the ibsys 
Operating System is assembled. The unit assignment 
control cards are normally used only for the temporary 
reassignment of units. 

Unit Designation 

Physical input/output units and logical system unit 
functions are designated on the unit assignment con- 
trol cards as described below. 

729 Magnetic Tape Units: A 729 tape unit is desig- 
nated as xk, where x is the channel (A through H) 
and k is the tape unit number (0 through 9) on that 
channel. 

Card and Printer Units: The card and printer units 
are designated as rdx, pux, and prx, where rd, pu, and 
pr are the card reader, card punch, and printer, re- 
spectively, and x is the channel ( A through H ) . 

Disk Storage Units: A disk storage unit is designated 
as xDam/s, where x is the channel ( A through H ) , D 
designates disk, a is the access arm (0 or 1), m is the 
module (0 through 9), and s is the setting of the 
Data Channel Switch (0 for switch setting 1; 1 for 
switch setting 2). If the /s is missing from the unit 
designation, switch setting 1 is assumed. 

Drum Storage Units: A drum storage unit is des- 
ignated as xNam/s, where x is the channel ( A through 
H), N designates drum, a is the access arm (0), m is 
the module (0, 2, 4, 6, or 8), and s is the setting of the 
Data Channel Switch (0 for switch setting 1; 1 for 
switch setting 2). If the /s is missing from the unit 
designation, switch setting 1 is assumed. 

7340 Hypertape Drives: A 7340 Hypertape Drive is 
designated as xHk/s, where x is the channel (A 
through H), H designates Hypertape, k is the drive 
number (0 through 9), and s is the setting of the 
Data Channel Switch (0 for switch setting 1; 1 for 
switch setting 2). If the /s is missing from the unit 
designation, switch setting 1 is assumed. 

System Unit Functions: A system unit function is 
designated as sysxxx or SYsyyy, where sysxxx or SYsyyy 
is the symbolic name for one of the system unit func- 
tions listed in Figure 4. 

$DETACH Card 

Format: 



1 



16 
Unit 



$DETACH 

This card causes the specified unit to be detached. 
If the unit is assigned to a system unit function, the 
assignment is cancelled. The unit will remain un- 
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Symbolic Name 


Function 


SYSLB1 


Library 1 


SYSLB2 


Library 2 


SYSLB3 


Library 3 


SYSLB4 


Library 4 


SYSCRD 


Card Reader 


SYSPRT 


Printer 


SYSPCH 


Card Punch 


SYSOU1 


Output 


SYSOU2 


Alternate Output 


SYSIN1 


Input 


SYSIN2 


Alternate Input 


SYSPP1 


Peripheral Punch 


SYSPP2 


Alternate Peripheral Punch 


SYSCK1 


Checkpoint 


SYSCK2 


Alternate Checkpoint 


SYSUT1 


Utility 1 


SYSUT2 


Utility 2 


SYSUT3 


Utility 3 


SYSUT4 


Utility 4 


SYSUT5 


Utility 5 


SYSUT6 


Utility 6 


SYSUT7 


Utility 7 


SYSUT8 


Utility 8 


SYSUT9 


Utility 9 


Figure 4. Symbolic 


Names of System Unit Functions 



available and unassigned until it is made available 
by a sattach card, or until its status is restored by a 
srestore card or an initial start. The sdetach card may 
be used to temporarily deactivate a unit for mainte- 
nance purposes. 

$ATTACH Card 

Format: 

1 16 

$ ATTACH unit [,II] 

This card causes the specified unit to become at- 
tached. The unit attached by this card can be assigned 
to a system unit function by the next $as card. 

If the specified unit is a Model 11 or Model v 729 
Magnetic Tape Unit, this must be specified by n in 
the variable field of the card. If n does not appear in 
the variable field when a 729 Magnetic Tape Unit is 
specified, the System Supervisor assumes that the 
unit is a Model iv or vi. 

The sattach and sdetach cards may be used to 
alert the System Monitor to a physical change in 
the status of a unit. For example, if, at an installation, 
the sixth unit on channel D were physically discon- 
nected and then reconnected as the fifth unit on chan- 
nel C, this change in status might be indicated to the 
System Monitor by the following cards: 

1 16 

$ATTACH C5 
$DETACH D6 

$AS Card 

Format: 
1 

$AS 



16 



SYSxxx 



[•{!}] 



system unit function. If the tape density is specified 
by h, hi, or high, the density for the system unit func- 
tion is set to high. It is set to low if the specifications 
is l, lo, or low. If the density specification is absent, 
the density will be set according to the assembly 
parameter highlo. With the distributed System 
Library Tape, high density is assumed if the density 
is not specified on the card. 

This card may apply to a unit already attached. 
In this case, there is no need to detach the unit before 
reattaching it. The $as card releases the unit that was 
assigned to the system unit function before the $as 
card was recognized. If there are two or more $as 
cards in succession, the unit specified on the last 
recognized sattach card is assigned to the function 
specified on each $as card. 

If the last attached unit was a direct access storage 
unit, the format of the $as card is : 



1 

$AS 
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This card causes the unit specified on the last recog- 
nized sattach card to be assigned to the specified 



SYSxx,nnn,ccc,hh 

Here, nnn and ccc must be replaced by three-digit 
numbers denoting the number of cylinders (nnn) and 
the starting cylinder ( ccc ) of the direct access storage 
unit assigned to the system unit function. A two- 
character symbol, representing the HA2 home address 
identifier, should be placed in the next field ( hh ) . Any 
blanks or zeros in this field will be converted to 
octal 12s. 

For example, to assign 25 cylinders of a 1301 or 2302 

Disk Storage Unit [starting with cylinder 125 (load 

point) on access arm 0, in module on channel E, 

switch setting 2, with a HA2 of pq] as System Utility 

Unit 3 ( sysut3 ) , the following control cards would be 

used: 

1 16 

$ ATTACH ED00/1 

$AS SYSUT3,025,125,PQ 

Note that the/1 corresponds to a switch setting of 2. 

$RELEASE Card 

Format: 

1 16 

$RELEASE SYSxxx 

This card causes the unit assigned to the specified 
system unit function to be released from the function. 
If the unit was concurrently assigned to other system 
unit functions, it remains assigned to those functions. 

$SWITCH Card 

Format: 

1 16 

$SWITCH SYSxxx.SYSyyy 

This card causes the units assigned to the two speci- 
fied system unit functions to be transposed; that is, 
the unit assigned to sysxxx is assigned to SYsyyy, and 
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the unit that was assigned to SYsyyy is assigned to 
sysxxx. Physical density settings of the units remain 
the same. 

$CARDS Card 

Format: 

1 16 

$CARDS 

This card causes the System Supervisor to read 
succeeding control cards from the unit assigned as 
the System Card Reader (syscrd). 

$TAPE Card 

Format: 

1 16 

$TAPE 

This card causes the System Supervisor to read 
succeeding control cards from the unit assigned as 
the System Input Unit ( sysini ) . 

Tape Manipulation Control Cards 

The tape manipulation control cards provide the 
operator and programmer with facilities for the auto- 
matic manipulating of tape units assigned to system 
unit functions. If no unit is assigned to the system 
unit function specified on a tape manipulation control 
card, or if the unit assigned to the function is not a 
729 tape unit or a 7340 Hypertape Drive, the card has 
no effect. The sendfile, srewind, and $remove cards 
have the same effect on a 7340 Hypertape Drive and a 
729 Magnetic Tape Unit. 

$ENDFILE Card 

Format: 

1 16 

$ENDFILE SYSxxx 

This card causes the tape unit assigned to the 
specified system unit functions to write, on the tape, 
an end-of-file gap followed by a tape mark. No test 
is made to determine if the operation is invalid, such 
as writing a tape mark on the System Input Unit. 



$REWIND Card 

Format: 

1 16 

$REWIND SYSxxx 

This card causes a tape unit assigned to the speci- 
fied system unit function to be rewound. If the speci- 
fied function is sysoui, further use of the System Out- 
put Unit by the System Supervisor is suspended until 
a $jor card is read or the System Supervisor is called 
into core storage again by a sirsys card or by a sub- 
system. 

SREMOVE Card 

Format: 



$REMOVE 



16 
SYSxxx 



This card causes a tape unit assigned to the speci- 
fied system unit function to be rewound and unloaded. 
If the specified function is sysoui, further use of the 
System Output Unit by the System Supervisor is 
suspended until a $jor card is read or the System 
Supervisor is called into core storage again by a sihsys 
card or by a subsystem. 

$UNLOAD Card 

Format: 



1 



16 
SYSxxx 



$UNLOAD 

This card causes the Hypertape assigned to the 
specified system unit function to be unloaded without 
rewinding. If a 729 tape unit is assigned to the speci- 
fied system unit function, the sunload card will be 
interpreted as a $remove card. 

$PROTECT Card 

Format: 



1 



16 
SYSxxx 



$PROTECT 

This card causes the Hypertape assigned to the 
specified system unit function to be file-protected. The 
sprotect card is ignored if a Hypertape drive is not 
assigned to the specified system unit function. 
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System Core-Storage Dump Program 



General Description 

The System Core-Storage Dump Program is designed 
to facilitate the testing of programs under System 
Monitor control. To perform this function, snap dump 
and post-mortem dump options have been provided. 
The snap dump option of the Core-Storage Dump 
Program can dump and edit one or more sequential 
locations of core storage during the execution of an 
object program. After the dump is completed, core 
storage is returned to its original condition and con- 
trol is returned to that point in the object program 
from which the dump was called. The post-mortem 
dump option of the Core-Storage Dump Program 
dumps core storage in the same manner as the snap 
durnp option, but at its completion control is returned 
to the System Supervisor which then skips cards on 
the System Input File until a $stop card or the next 
job or job segment is encountered. It then begins to 
process control cards. A job always begins with a $job 
card, and a job segment always begins with a $execute 
or $ibsys card. 

The format, the limits, and the output units for 
both the snap and post-mortem forms of the core 
storage dump may be either assembly defined or speci- 
fied by a control word*. For the post-mortem dump, 
the additional option of defining these parameters with 
the console entry keys is provided. 

When a dump is requested, the System Nucleus 
writes a portion of core storage onto the alternate 
System Peripheral Punch Unit (syspp2), reads in the 
Core-Storage Dump Program, and transfers control 
to it. If the console entry key option is requested, a 
halt occurs to allow the insertion of dump parameters. 
The Core-Storage Dump Program dumps the edited 
output onto the System Output Unit, onto the System 
Printer, or onto both. 



Using the System Core-Storage Dump Program 

Transfer to Dump Instructions 

To obtain a dump of core storage during the execution 
of an object program, insert one of the following in- 



*If no parameters are specified when a dump is requested, the dump will 
be accomplished using parameters within the Core-Storage Dump Pro- 
gram. These parameters are established when the Core-Storage Dump 
Program is assembled. (See the section "System Library Preparation and 
Maintenance." ) 



structions in the body of the source program at the 
point at which the dump is required: 

TRA SYSDMP: This instruction provides a post- 
mortem dump of all of core storage in an assembly 
defined format. 

TRA SYSDMP with Sense Switch 4 Down: This in- 
struction results in a post-mortem dump, in accordance 
with the parameters entered by means of the console 
entry keys. Before the dump is executed, a halt occurs 
and a message requesting insertion of dump param- 
eters is printed on the System Printer. 

TSX SYSDMP, 4, 1 Followed by a Parameter Control 
Word: This sequence results in a post-mortem dump, 
in accordance with the information from the parameter 
control word. The parameter control word is described 
in the section "Dump Parameters." 

TSX SYSDMP, 4, Followed by a Parameter Control 
Word: This sequence results in a snap dump, in ac- 
cordance with the information from the parameter 
control word. For example, the following instruction 
and control word would result in an octal snap dump 
on the System Output Tape of storage locations be- 
ginning at stdmp and ending at endmp. 

8 16 

TSX SYSDMP,4,0 

PON ENDMP,0,STDMP 



Dump Parameters 

The dump parameters are entered either by a param- 
eter control word (Figure 5) for a snap dump or by a 
parameter control word or the console entry keys 
for a post-mortem dump. Any one of six dump formats 
(Figure 6) can be specified. In the distributed version 
of the Core-Storage Dump Program, output is single 
spaced. The various parts of the parameter control 
word are interpreted as follows: 

Prefix PON 1 FORMAT A - Octal, eight words 

per line. 

PTW 2 FORMAT B - BCD, sixteen words 

per line. 

PTH 3 FORMAT C - SQUEZY, Mnemon- 

ics with address and tag field. If the 
Core-Storage Dump Program cannot 
interpret the operation code, the octal 
representation is given. 

MZE 4 FORMAT D - Octal and SQUEZY. 

If the SQUEZY word would normally 
have appeared in octal form, it is not 
listed twice, but is suppressed. Other- 
wise, both the octal word and the 
SQUEZY word are listed. 
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MON 5 FORMAT E - Octal and mne- 

monics. 
MTW 6 FORMAT F - Octal, mnemonics, 

and BCD. A BCD interpretation of 
the word is listed to the right of the 
mnemonic. 
Address The ending location of the dump. 

Tag = Dump onto System Output Unit. 

1 = Dump onto System Printer. 

2 = Dump onto both System Output Unit and 

System Printer. 

Decrement The starting location of the dump. 



Prefix 



Decrement 



Tag 



Address 



Format 
Code 


Starting Location 


Output 
Code 


Ending Location 



23- 



•17 18- 



-20 21- 



-35 



Figure 5. Parameter Control Word Format 



Notes: The limits of the requested dump may be 
stated in any order, i.e., the starting parameter in the 
address field and the ending parameter in the dec- 
rement field, or vice versa. 

In the distributed version of the Core-Storage Dump 
Program, the dump is always made onto the System 
Output Unit only, regardless of the contents of the tag 
position of the parameter control word. 



A parameter control word of all zeros will provide 
a full core storage dump in the assembly defined 
format. In the distributed version, format 3(C) in 
Figure 6 is used. 



Machine Status at the End of a Core 
Storage Dump 

If any input/output operation had been in progress 
when the snap dump routine was called, the traps 
resulting from this operation are lost if they occurred 
on the channels used by the Core-Storage Dump Pro- 
gram. Since the System Loader disables all traps when 
loading the Core-Storage Dump Program, and the 
dump resets the work tape data channel when restor- 
ing core storage, it is recommended that all input/ 
output operations be terminated before calling in the 
Core-Storage Dump Program. 

At the completion of a snap dump, all of core storage, 
except locations sysend-18 through sysend, are restored. 
These last 19 locations are destroyed by the restore 
portion of the snap dump routine. Because of space 
restrictions, no error checking of the work tape is 
done while restoring core storage. The snap dump 
routine also repositions the System Library Tape to 
its position prior to the core storage dump as part of 
its restore process. 
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Format A— Octal 

AC 

000000000000 



MQ SENSE INO 
000000000000 001321000000 



INDICATORS 

0-BIT P-BIT TRAP OCT IOT OFL 1 

OFF OFF OFF OFF OFF ON OFF 

00000 100000000000 100000000000 042000000377 
00010 00210000363? 000000000000 000000000000 
00020 000000000000 002100000751 000000000000 
00030 000000000031 000060000030 000000000033 



KEYS XR1 XR2 

000000000000 00001 00006 

-77777 -77772 
SENSE LIGHTS 



XR4 

74320 

-03460 



2 3 4 
OFF OFF OFF 
002000005557 002100003626 
002100000751 000000000000 
002100000751 000000000025 
000060000032 001321000000 



SENSE SWITCHES 



2 

OFF 



1 

ON 

000000000000 
002100000751 
000060000024 
000060000034 



3 4 

OFF ON 
000000000000 
000000000000 
000000000027 
001321000000 



5 6 

OFF ON 
002100003630 
002100000751 
00006000002b 
001"i?lO0O000 



Format B-- BCD 



MQ SENSE IND KEYS XRl 

000000000000 101201300475 000000000000 00001 

-77777 
SENSE LIGHTS 
IOT OFL 12 3 4 

urr urr U rr w. . OFF ON OFF OFF OFF OFF 

00000 0K90UT 800000 4*003» 0*00»» OAOO«F 000000 000000 OAOCH 0A00«* 000000 000000 0A007R 000000 0A007R 000000 0A007R 
00020 000000 0A007R 000000 0A007R OOOOOE 00 000 OOOOOG 00 OOF 000001 00 OOH 00000. 00 00+ 801H4. 00 00) 801H4* 801H4. 
00040 000000 000000 000000 80008U 000000 80108U 000000 80208U 000000 80308U 000000 80408U 000000 80508U 000000 80608U 



AC 
-300000005176 



INDICATORS 
Q-BIT P-BIT TRAP OCT 
OFF OFF OFF OFF 



XR2 


XR4 










77323 


71371 










-00455 


-06407 


SENSE 


SWITCHES 








1 


2 


3 4 


5 


6 




ON 


OFF 


OFF ON 


OFF 


ON 



FormatC — SQUEZY 



AC MQ SENSE INO 


KEYS 




XRl 


XR2 


XR4 












-300000005176 000000000000 101201300475 


000000000700 


00001 
-77777 


77323 

-00455 


71371 
-06407 












INDICATORS 


SENSE LIGHTS 








SENSE 


: SWITCHES 






Q-BIT P-BIT TRAP DCT IOT OFL 


1 2 


3 


4 




1 


2 


3 


t 


5 


6 


OFF OFF OFF OFF OFF ON 


OFF OFF 


OFF 


OFF 




ON 


OFF 


OFF 


ON 


OFF 


ON 


00000 244211006463 100000000000 HPR 


377 TRA 


5557 


TIR 


3626 


HTR 




HTR 




TTR 


3630 


00010 TTR 3632 HTR HTR 


TTR 


751 


HTR 




TTR 


751 


HTR 




TTR 


751 


00020 HTR TTR 751 HTR 


TTR 


751 


HTR 


25 


HTR • 


24 


HTR 


27 


HTR • db 



Format D — Octal and SQUEZY 



AC 
-300000005176 



MQ 
000000000000 



Q-BIT P-BIT 

OFF 
00000 



INDICATORS 



SENSE IND KEYS XRl XR2 XR4 

101201300475 000000000000 00001 77323 71371 

-77777 -00455 -06407 
SENSE LIGHTS 



00010 



00020 



TRAP 
OFF OFF 
244211006463 



SENSE 

2 
OFF 



002100003632 
TTR 3632 
000000000000 
HTR 



DCT IOT OFL 12 3 4 1 

OFF OFF ON OFF OFF OFF OFF ON 

100000000000 042000000377 002000005557 002100003626 000000000000 

HPR 377 TRA 5557 TTR 3626 HTR 

000000000000 002100000751 000000000000 002100000751 

HTR TTR 751 HTR TTR 751 

000000000000 002100000751 000000000025 000060000024 

HTR TTR 751 HTR 25 HTR • 24 



000000000000 
HTR 

002100000751 
TTR 751 



SWITCHES 
3 4 

OFF ON 
000000000000 
HTR 

000000000000 
HTR 

000000000027 
HTR 27 



5 6 

OFF ON 
002100003630 
ITR 3630 
002100000751 
TTR 751 
000060000026 
HTR • 26 



Format E — Octal and Mnemonics 





AC 


MQ SENSE 


1 IND KEYS XRl 


XR2 


XR4 








-300000005176 000000000000 101201300475 000000000000 00001 


77323 


71371 
















-77777 


-00455 


-06407 










INDICATORS 


SENSE LIGHTS 








SENSE SWITCHES 




Q-BIT 


P-dlT TRAP 


DCT IOT OFL 1 


2 3 


«t 




1 


2 


3 4 


5 6 


0*F 


OFF OFF 


OFF OFF ON OFF 


OFF OFF 


OFF 




ON 


OFF 


OFF ON 


OFF ON 


00000 


244211006463 


100000000000 


042000000377 


002000005557 


002100003626 


000000000000 


000000000000 


002100003630 




TIX 


TXI 


HPR 


TRA 


TTR 




HTR 




HTR 


TTR 


00010 


002100003632 


000000000000 


000000000000 


002100000751 


000000000000 


002100000751 


000000000000 


002100000751 




TTR 


HTR 


HTR 


TTR 


HTR 




TTR 




HTR 


TTR 


00020 


000000000000 


002100000751 


000000000000 


002100000751 


000000000025 


000060000024 


000000000027 


000060000026 




HTR 


TTR 


HTR 


TTR 


HTR 




HTR • 




HTR 


HTR • 


00030 


000000000031 


000060000030 


000000000033 


000060000032 


101201300475 


000060000034 


101201300475 


101201300475 




HTR 


HTR • 


HTR 


HTR • 


TXI 




HTR • 




TXI 


TXI 



Format F — Octal, Mnemonics, and BCD 



AC 
-300000005176 



MQ 
000000000000 



SENSE IND 
101201300475 



KEYS 
000000000000 



INDICATORS 



XRl 
00001 
-77777 
SENSE LIGHTS 



Q-BIT P-BIT 

OFF 
00000 

00010 

00020 



TRAP 
OFF OFF 
24421 HM)6463 
TIX DK90UT 
002100003632 
TTR 0A00»+ 
000000000000 
HTR 000000 



DCT IOT OFL 1 

OFF OFF ON OFF 

100000000000 042000000377 



TXI 800000 
000000000000 
HTR 000000 
002100000751 
TTR 0A007R 



HPR 4*003* 
000000000000 
HTR 000000 
000000000000 
HTR 000000 



2 3 

OFF OFF 
002000005557 
TRA 0+00»* 
002100000751 
TTR 0A007R 
002100000751 
TTR 0A007R 



XR2 
77323 

-00455 
LGC 
j2160 



Figure 6. Core-Storage Dump Formats 



XR4 

71371 

-06407 



SENSE SWITCHES 



4 
OFF 
002100003626 
TTR OAOO»F 
000000000000 
HTR 000000 
000000000025 
HTR OOOOOE 



I 

ON 



2 

OFF 



000000000000 
HTR 000000 
002100000751 
TTR 0A007R 
000060000024 
HTR • 00 OOD 



3 4 

OFF ON 
000000000000 
HTR 000000 
000000000000 
HTR 000000 
000000000027 
HTR OOOOOG 



5 6 

OFF ON 
002100003630 
TTR OAO0»H 
002100000751 
TTR 0A007R 
000060000026 
HTR • 00 OOF 
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System Nucleus 



Function and Organization 

The System Nucleus is a portion of the System Moni- 
tor which remains in core storage at all times and 
provides common facilities for intercommunication and 
control between the System Monitor and the sub- 
systems, and between the subsystems themselves. The 
Input/Output Executor and the unit control blocks for 
the input/output units are described separately in the 
section "Input/Output Executor" although they may 
be considered part of the System Nucleus in that they 
normally remain in core storage at all times and provide 
common facilities for the System Monitor and the sub- 
systems. 

The System Nucleus consists of the following: 

1. The Communication Region containing constants, 
control words, and transfer words that are required 
for intercommunication between the System Monitor 
and the subsystems. 

2. The System Unit Function ( sysuni ) Table, which 
is used to keep account of the units assigned to system 
unit functions. 

3. The Disk/Drum Limits Table, which when direct 
access storage is employed, supplements the func- 
tion of the System Unit Function Table by defining 
the portion of disk or drum storage assigned to each 
system unit function. 

4. The Unit Control Block Table, which consists of a 
word for each channel containing the address of the 
first unit control block for the channel, the total num- 
ber of input/output units assigned to the channel, and 
the number of card units assigned to the channel.* 

5. The Unit Availability Table, which consists of 
one word for each channel that serves as an entry 
point to a chain of available units on the channel. 

6. The System Loader, which is used by the System 
Monitor and the subsystems for scatter-loading records 
from the System Library Unit. 

7. An interrupt routine, which is used by the System 
Monitor and the subsystems to interrupt processing be- 
tween jobs for the purpose of manual intervention. 

8. A dump-calling routine, which is a bootstrap rou- 
tine for loading the Core-Storage Dump Program 
whenever a dump is called for by the System Monitor, 
a subsystem, an object program, or manually by the 
operator. 

Of the various portions of the System Nucleus, the 
most important, so far as the systems programmer is 

♦Each input/output unit that may be referred to by the IBSYS Operating 
System is represented internally by a block of four consecutive words 
called a unit control block. The unit control block contains information 
concerning the status of each input/output device. A complete description 
of unit control blocks is provided in the section "Input/Output Executor." 



concerned, ,are the Communication Region, the System 
Unit Function Table, the Disk/Drum Limits Table, 
and the Unit Availability Table. Therefore, each of 
these is described below, together with job control 
communication requirements for subsystems operating 
under the System Monitor. 



Communication Region 

The Communication Region of the System Nucleus 
consists of 32 consecutive core storage locations con- 
taining various constants, control words, and transfer 
words that may be referred to by the System Monitor 
or by any of the subsystems operating under it. The 
function of each entry in the Communication Region, 
together with its octal absolute address and its sym- 
bolic address, is given in Figure 7. A more complete 
description of the function of each entry is given in 
Appendix A. 

The entries in the Communication Region may be 
referred to by their absolute addresses, since their 



Octal 
Address 

100 
101 
102 
103 
104 
105 
106 
107 
110 

111 
112 
113 
114 
115 
116 
117 
120 

121 
122 
123 
124 

125 
126 
127 
130 
131 
132 
133 
134 
135 
136 
137 



Symbolic 
Address 

SYSTRA 

SYSDAT 

SYSCUR 

SYSRET 

SYS KEY 

SYSSWS 

SYSPOS 

SYSUNI 

SYSUBC 

SYSUAV 

SYSUCW 

SYSRPT 

SYSCEM 

SYSDMP 

SYSIOX 

SYSIDR 

SYSCO R 

SYSLDR 
SYSACC 
SYSPID 
SYSCYD 

SYSCYD+1 
SYSSLD 
SYSTCH 
SYSTCH+1 
SYSTWT 
SYS GET 
SYS JOB 
.CHEXI i 
.MODSW' 



Function 

Transfer instruction to current subsystem 

Date Word 

Name of current subsystem 

Location to which each subsystem returns 

Contents of entry keys at initial start 

Contents of sense switches at initial start 

Initial position and index of current subsystem 

Location and length of System Unit Function Table 

Location and length of table of unit control block 

locators by channel 
Location and length of the Unit Availability Table 
Location and length of all the unit control blocks 
Transfer to between-jobs interrupt routine 
Transfer to customer engineering diagnostic routine 
Transfer to bootstrap for core storage dump 
Location and length of IOEX communication Table 
Transfer to installation accounting routine, if any. 
Lower limit'of usable core storage in decrement, 

upper limit in address 
Transfer to system scatter-load routine 
Installation accounting routine Communication 
Installation accounting routine Communication 
Channel commands for system to copy and 

disconnect 

Self-loading sequence 
Self-loading sequence 

System trap, wait, and transfer point 

Subsystem communication with System Supervisor 

Job control word 

Cells tested by all subsystems to determine whether in 

direct-couple environment or not 

Reserved for future IBM use 

Reserved for future IBM use 



Figure 7. Communication Region of System Nucleus 

System Nucleus 21 



location will not change and is not dependent on the 
input/output configuration of the Operating System. 
In addition, these entries may be referred to by their 
symbolic addresses (without further definition in the 
source program) in any Macro Assembly Program 
( map ) relocatable assembly, with or without monsym 
specified; in a map absolute assembly where the 
monsym or jobsym option is specified on the sibmap 
control card; or in a Fortran ii Assembly Program 
(fap) assembly if a Save Symbol Table (sst) pseudo- 
operation is included in the first card group of the fap 
source program. 



System Unit Function Table 

The System Unit Function Table (sysuni) consists of 
24 entries, one for each of the 24 possible system unit 
functions. The octal absolute address, the symbol, and 
the system unit function for each entry are given in 
Figure 8. The entries in this table may be referred to 
by their symbols (without further definition in the 
source program ) in any map relocatable assembly, with 
or without monsym specified; in a map absolute 
assembly where the monsym or jobsym option is speci- 
fied on the $ibmap control card; and in a fap assembly 
where a Save Symbol Table (sst) pseudo-operation is 
included in the first card group of the fap language 
source program. In the last two cases, the symbols 
listed in Figure 8 become the symbolic addresses of 
the table entries, that is, the symbols defined by the 
assemblers are equal to their octal addresses. 



Octal 






Address 


Symbol 


System Unit Function 


140 


SYS LB 1 


Library 1 


141 


SYSLB2 


Library 2 


142 


SYSLB3 


Library 3 


143 


SYSLB4 


Library 4 .. 


144 


SYSCRD 


System Card Reader 


145 


sysprt 


System Printer 


146 


syspch 


System Punch 


147 


SYSOU1 


Output 


150 


SYSOU2 


Alternate Output 


151 


SYSIN1 


Input 


152 


SYSIN2 


Alternate Input 


153 


SYSPP1 


Peripheral Punch 


154 


SYSPP2 


Alternate Peripheral Punch 


155 


SYSCK1 


Checkpoint 1 


156 


SYSCK2 


Checkpoint 2 


157 


SYSUT1 


Utility 1 


160 


SYSUT2 


Utility 2 


161 


SYSUT3 


Utility 3 


162 


SYSUT4 


Utility 4 


163 


SYSUT5 


Utility 5 


164 


SYSUT6 


Utility 6 


165 


SYSUT7 


Utility 7 


166 


SYSUT8 


Utility 8 


167 


SYSUT9 


Utility 9 



Figure 8. System Unit Functions 



For example, the symbol syslbi represents 140, and 
sysut5 represents 163. However, in a map relocatable 
assembly, if the monsym option is not specified on the 
$ibmap control card, the symbols defined at load time 
are equal to index numbers beginning with for syslbi 
and ending with 27 8 for sysut9. In order to obtain the 
correct address of an entry in the sysuni table when 
the symbols are defined in this way, the index number 
represented by the symbol for that entry must be added 
to the contents of the address portion of the sysuni 
entry in the Communication Region of the Nucleus. 
Since the address portion of this word contains the ad- 
dress of the first word of the System Unit Function 
Table, the resulting sum is equal to the address of the 
sysuni table entry represented by the symbol used in 
the addition. For example, adding sysoui (defined as 
7 ) to the address portion of the sysuni entry ( 140 8 ) 
results in the address ( 147 8 ) of the entry in the sysuni 
table for the System Output Unit. 

The address portion of each entry in the System Unit 
Function Table contains the address of the first word 
of the unit control block for the unit assigned to the 
system unit function. If no unit is assigned to the 
system unit function, the address portion of the entry 
contains zeros. Normal assignments of units to system 
unit functions are specified when the System Monitor 
is assembled. However, normal unit assignments may 
be changed temporarily by unit assignment control 
cards. 

Tape density is indicated by an entry in the sign bit 
position. Low density is specified when the sign is plus 
(pze), and high density is specified when the sign is 
minus (mze). The System Monitor will only set the 
densities of the tape units it uses. Each subsystem 
has the responsibility for setting the densities of the 
tape units it uses. 

When direct access storage is assigned to a system 
unit function, bits 6 through 17 of the entry for the 
system unit function contain the ha2 home address 
identifier that was specified on the $as control card 
used to assign the disk or drum module to the function. 
Bits 3 through 5 are zero. 



HA2 Table 

An auxiliary system unit function table, the Home Ad- 
dress 2 (ha2) Table, is located in the System Super- 
visor and has 24 entries corresponding to those of the 
System Unit Function Table. The ha2 Table, which 
defines the HA2 of each system unit function, is initially 
assembled with bm for the ha2's of syslbi through 
syslb4, and 00 (oct 1212) for the ha2's of the remain- 
ing System Unit functions (excluding syscrd, sysprt, 
and syspch). 



22 



Although this table is not located in the Nucleus, 
HA2's are generated into the decrement of the System 
Unit Function Table entries from this table for those 
system units which are permanently assigned to disk 
or drum. The symbolic location of this table is ha2tbl. 



These procedures are required to ensure proper job 
and job segment control, proper control of between- 
jobs and end-of-jobs interrupts, and restoration, if 
necessary, of input/output unit assignments at the 
beginning of each job. 



Disk /Drum Limits Table 

The Disk/Drum Limits Table is located immediately 
following the System Unit Function Table. It contains 
24 entries corresponding to the 24 entries of the Sys- 
tem Unit Function Table. When an entry in the System 
Unit Function Table contains the address of a unit 
control block for a direct access storage module, the 
corresponding entry in the Disk/Drum Limits Table 
contains a parameter word, in binary form, which de- 
signates the first and last tracks of the consecutive 
tracks of the module that are assigned to the system 
unit function. Since direct access storage cannot be 
assigned to the System Card Reader, System Printer, 
and System Card Punch functions, the entries in the 
Disk/Drum Limits Table corresponding to the entries 
for these three functions in the System Unit Function 
Table are used for other purposes by the operating 
system. The parameter words in the Disk/Drum Limits 
Table have the following format: 

PZE DORG„DEND 



Unit Availability Table 

The Unit Availability Table consists of one entry per 
input/output channel, beginning with channel A. Each 
entry contains the address of the first word of the unit 
control block for the first unassigned ( available ) unit 
on the channel. The address portion of the first word 
of the unit control block for each unassigned unit on a 
channel contains the address of the first word of the 
unit control block for the next unassigned unit on the 
channel. In this way, a unit availability chain for each 
channel is formed, beginning with an entry in the Unit 
Availability Table. The end of the chain is indicated 
by zeros in the address portion of the first word of the 
unit control block for the last unassigned unit on the 
channel. Whenever a subsystem requires the use of an 
available unit, it interrogates a unit availability chain 
by way of a Unit Availability Table entry and removes 
the unit from the chain. 



Job Control Communication with Subsystems 

Each of the subsystems operating under the System 
Monitor must follow certain operation procedures in- 
volving communication with the System Monitor. 



Restoration of Unit Assignments Between Jobs 

Restoration of input/output unit assignments is re- 
quired at the beginning of a job if, during the previous 
job, a $ibsys card was followed by a $as, sswitch, or 
$release card or a subsystem (or an object program 
running under the subsystem) removed or replaced a 
unit in a unit availability chain. If either of these con- 
ditions occurred, the System Supervisor, at the begin- 
ning of the next job, begins restoring unit assignments 
by first chaining all attached units on each channel 
in ascending order in accordance with the unit or 
module number. Any unit assigned to a system unit 
function at initial start is then reassigned by the System 
Supervisor to the same function, provided the unit is 
not currently assigned to a system input, system out- 
put, or system peripheral punch function or is not 
currently assigned to a system unit function in place of 
a detached unit. Any unit assigned to a system unit 
function is removed from the unit availability chain 
for its channel unless it is a direct access storage 
module. The restoration of unit assignments at the 
beginning of a job differs from that initiated by the 
$restore card in that detached units remain detached 
and current system input, system output and system 
peripheral punch assignments are not changed. 

Communication Region Locations SYSRET, 
SYSGET and SYSJOB 

Communications between the subsystems and the 
System Supervisor is carried out chiefly by way of 
three locations in the Communication Region of the 
System Nucleus. These three locations are sysret, 
sysget and sysjob. The function of each of these loca- 
tions is described below. 

Communication Location SYSRET 

Whenever a subsystem is required to return control to 
the System Supervisor, it transfers to the location 
sysret. As a result, the System Supervisor is read into 
core storage and control is relinquished to it. 

Communication Location SYSGET 

Before returning control to the System Supervisor, a 
subsystem must ensure that a word is stored in the 
sysget location which indicates to the System Super- 
visor the reason why control was returned to it by the 
subsystem. In addition, whenever a post-mortem dump 
is performed by the System Core-Storage Dump Pro- 
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gram it places a word in sysget (to indicate that a 
post-mortem dump was performed) before it returns 
control to the System Supervisor. When the System 
Supervisor obtains control from the dump program 
or from a subsystem, it examines the word in sysget 
and takes appropriate action. 

If the word in the sysget location is a subsystem 
name, it indicates to the System Supervisor that a 
subsystem read a sexecute card containing a subsystem 
name other than its own. Therefore, the System Super- 
visor loads into core storage the first record of the 
subsystem whose name was in the sysget location and 
relinquishes control to it. 

If the word in the sysget location is "ibsyst," it indi- 
cates to the System Supervisor that a sibsys control 
card was read by a subsystem. Therefore, the System 
Supervisor begins processing control cards on the in- 
put file, beginning with the next card. 

If the word in the sysget location is "ibsxe:c," it indi- 
cates to the System Supervisor either of the following: 

1. A post-mortem core-storage dump was taken by a 
subsystem, an object program, or the operator; there- 
fore, a job segment was not completed. 

2. A subsystem could not complete a job segment. 

In either case, the System Supervisor skips on the 
system input file until a $ibsys, sexecute, $job, or $stop 
control card is encountered and then processes cards, 
normally beginning with that card. 

If the word in the sysget location is "ibsnxt," it indi- 
cates to the System Supervisor that a subsystem has 
determined that a job cannot be completed. Therefore, 
the System Supervisor skips on the system input file 
until a $job or $stop control card is encountered and 
then processes cards normally, beginning with that 
card. 

If the word in the sysget location is "$STOPb," where 
"b" is a blank, it indicates to the System Supervisor that 
a $stop control card was read by a subsystem. There- 
fore, the System Supervisor initiates an end-of-jobs se- 
quence as though it had read the $stop card. 

If the word in the sysget location is "ibsbsr," it indi- 
cates to the System Supervisor that a $job card was 
read by a subsystem and either a between- jobs inter- 
rupt condition exists or an input/output unit was re- 
assigned or made unavailable during the previous job. 
In either case, the System Supervisor proceeds as 
though it had just read a $job card. Refer to the descrip- 
tion of the $job card in the section "System Supervisor." 

Communication Location SYSJOB 

The communication location sysjob is used by the 
System Supervisor and the subsystems in controlling 
the processing of jobs. 



The sign bit of the word indicates whether or not 
any input/output unit assignments need be restored 
at the beginning of the next job. A minus sign indicates 
that restoration is necessary and a plus sign indicates 
that restoration is not necessary. The System Super- 
visor sets the sign of sysjob to minus if it processes a 
sas, sswitch, or srelease control card. Similarly, each 
subsystem must set the sign to minus if it is about to 
change a unit availability chain. The sign should be 
set to minus before the change is made in the event the 
job "blows-up" and the subsystem does not regain 
control. The sign bit is interrogated at the beginning 
of each new job by the Nucleus routine sysrpt to de- 
termine if restoration of input/output unit assignments 
is required. It is then set to plus by the System Super- 
visor before actual processing of the job begins. 

Bit 17 of sysjob is used by the subsystems to indicate 
to one another whether or not a previous job segment 
could not be completed. Whenever a subsystem (or 
Editor) determines that it cannot complete a job seg- 
ment, it sets bit 17 of sysjob to a 1 and stores the word 
"ibsxec" in the sysget location. It then returns control 
to the System Supervisor, which skips to the next job 
segment. 

When either a subsystem or the System Editor gains 
control at the beginning of a job segment, it tests bit 
17 of sysjob and proceeds normally if it is a 0. How- 
ever, if it is a 1, the subsystem may discontinue the 
present job segment by storing the word "ibsxec" in 
the sysget location and returning control to the Sys- 
tem Supervisor by way of sysret. This is done in cases 
where the successful execution of the present job seg- 
ment would be jeopardized as a result of the previous 
job segment not being completed. At the completion of 
a post-mortem dump, the System Core-Storage Dump 
Program sets bit 17 to a 1 and stores the word "ibsxec" 
in the sysget location before returning control to the 
System Supervisor. The Nucleus routine sysrpt clears 
bit 17 to at the beginning of each job. 

The ibjob monitor sets bit 16 of sysjob to a 1 to 
indicate that the Debugging Postprocessor is to be 
called. The ibjob monitor regains control after an ex- 
ecution involving Debug by presetting the contents 

of SYSGET tO "iBJOBb." 

The address portion of sysjob contains a count of the 
number of jobs processed on the current input file. 
This count is maintained by the System Supervisor 
and is used to locate a specified job when the srestart 
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± control card is processed. The subsystems are in 
no way concerned with the job count. 

Recognition of System Supervisor Control Cards 
by Subsystems 

Each subsystem must recognize and act upon the $ibsys, 
sexecute, $stop, $iD, and $job control cards. The action 
that must be taken by a subsystem when each card is 
recognized is as follows: 

$IBSYS Card 

When a $ibsys card is recognized by a subsystem, it 
must return control to the System Supervisor. When- 
ever a subsystem gains control from the System Super- 
visor, the sysget location will contain the word "ibsyst." 
Therefore, it is not necessary for the subsystem to load 
the word "ibsyst" into the sysget location when a 
sibsys card is recognized. 

SEXECUTE Card 

When a sexecute card is recognized by a subsystem 
and the subsystem name on the sexecute card is the 
name of the subsystem, the subsystem retains control 
and continues normal processing. Otherwise, the sub- 
system stores the name specified on the card into the 
sysget location and returns control to the System Super- 
visor by way of sysret. If the subsystem had changed 
an availability chain, it would have previously set the 
sign of sysjob to minus. 

$STOP Card 

When a subsystem recognizes a sstop card, whether 
or not it is located in the proper sequence on the input 
file, it loads the word "sTOPb" in the sysget location 
and returns control to the System Supervisor by way 
of sysret. 



$ID Card 

When a subsystem recognizes a $id card, it must tsx 
to sysidr as follows: 



TSX 
PZE 



SYSIDR,4 

L($ID) 



return 
where l($id) is the location of the first word of the 
buffer containing the sid card in bcd form. 

$JOB Card 

When a subsystem recognizes a $job card, whether or 
not it is located in the proper sequence on the input 
file, it loads the word "ibsbsr" into sysget and then ex- 
ecutes a tsx sysrpt, 4 instruction. The sysrpt routine 
in the System Nucleus will then determine if the System 
Supervisor must restore unit assignments (the sign of 
sysjob is minus) or control a between-jobs interrupt 
(sense switch 1 is down). If the System Supervisor 
must do either, control is passed to the System Super- 
visor by way of sysret. Otherwise, control is returned 
to the subsystem. When the subsystem regains control, 
it must restore the word "ibsyst" in the sysget location 
and tsx to sysidr as follows : 

TSX SYSIDR 

PZE L($JOB) 

return 

where l($job) is the location of the first word of the 
buffer containing the $job card in bcd form. 

If a $job card is read from the card reader by a sub- 
system, the System Monitor receives control and prints 
a $job card on- and off-line in the following format: 

1 16 

$JOB xxxxxx 

The variable field is printed as xxxxxx instead of the 
actual text because (1) there is no common buffer 
between the subsystems and the System Monitor, and 
(2) the card cannot be reread, since backspacing is 
not possible on the card reader. 
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Input/Output Executor 



The Input/Output Executor (ioex) consists of a trap 
supervisor and a number of utility routines that are 
used in common by the System Monitor and the sub- 
systems operating under its control. Any subsystem 
that is incorporated under the System Monitor and 
employs 729 Magnetic Tape Units, card equipment, 
direct access storage, or 7340 Hypertape Drives should 
use ioex to ensure centralized control of input/output 
activity. The use of a single trap supervisor by the 
subsystems and the System Monitor not only minimizes 
input/output coding but also (1) ensures proper 
coordination of trapping, (2) enables a running log to 
be kept of tape positions, (3) enables error recovery 
procedures to be standardized, and (4) simplifies the 
diagnosis of input/output failures. 

A subsystem communicates with ioex and calls ioex 
subroutines by way of a Communication Table located 
in storage just forward of ioex. Location sysiox in the 
Communication Region of the System Nucleus (Ap- 
pendix A) contains the address and length of this 
table. An entry in the ioex Communication Table may 
be referred to by its symbolic address when using 
either the Macro Assembly Program (map) or the 
Fortran ii Assembly Program (fap). However, the 
symbols used to represent the addresses of the table 
entries for map are different from the symbols used 
to represent the same addresses for fap. Both the map 
and fap symbolic addresses, together with the function 
of each entry in the ioex Communication Table, are 
listed in Figure 17 at the end of this section. When 
these entries are referred to symbolically using fap, 
a Save Symbol Table (sst) pseudo-operation must 
be included in the first card group of the fap source 
program. When these entries are referred to sym- 
bolically in a map absolute assembly, without defini- 
tion in the source program, the monsym or jobsym 
option must appear on the sibmap control card. (A 
map relocatable assembly leaves these symbols as 
undefined virtual symbols, which ibldr defines from 
symbols in the library. ) 

The following description of ioex, together with a 
symbolic listing of the ioex portion of the System 
Monitor, should provide the system programmer with 
the information required to use ioex. In both the 
description and the listing, the map symbols are used 
when referring to entries in the ioex Communication 
Table. The equivalent fap symbols may be obtained 
by reference to Figure 17. 

Unit Control Blocks 

Each input/output device that may be referred to 
by the ibsys Operating System is represented in ioex 



by a four-word unit control block. The unit control 
blocks are generated by the System Monitor at initial 
start in accordance with assembly parameters. The 
following describes the format and contents of the 
unit control blocks for 729 Magnetic Tape Units, card 
equipment, direct access modules, and 7340 Hypertape 
Drives. 

Unit Control Block for 729 Tape Units 
and Card Equipment 

Each 729 Magnetic Tape Unit and each card unit is 
represented in ioex by a four-word unit control block 
whose format is shown in Figure 9. 
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Figure 9. Unit Control Block for 729 Tape Units and Card 
Equipment 



The contents of each unit control block is interpreted 
as follows: 

Word I 

A: Availability Flag 
M: Attachment Flag 
A=0: The unit is assigned to a particular function, 
not necessarily a system unit function, and it 
is not in the availability chain. 
M=0: The assigned function of the unit is such 
that it should be repositioned when re- 
starting. 
M = l: The unit should not be repositioned when 
restarting (for example, if the unit is as- 
signed as SYSOUl, SYSOU2, SYSPPl, SYSPP2, 
SYSCKl, Or SYSCK2). 

A=l: The unit is. not assigned to any particular 
function. 
M = 0: The unit is attached to the channel and is 
in the availability chain. Card equipment 
is never in the availability chain. 
M = l: The unit is detached from the channel and 
cannot be used. 
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If the user desires to assign a unit in the availability 
chain to a function not included in the System Unit 
Function Table, he should set the availability flag to 
zero, remove the unit from the availability chain, 
and set the attachment flag to indicate whether or 
not the unit should be repositioned when restarting. 

T: Unit Type (for 729 tapes only) 
T=0: Model ii or v 
T = 1 : Model iv or vi 

R: Reserve Status Flag (intersystem use only) 

R = 0: The unit is not reserved. 

R = l: The unit is reserved. Address bits 24-35 of 
word 1 contain data (two characters) for 
intersystem pickup. The unit should not be 
assigned a system unit function or be in the 
unit availability chain. 

C: Channel Type 
C=0: 7607 channel 
C = l: 7909 channel 

Unit Address: The address of the input/output unit is 
contained here. If the unit is a tape, the address is 
the bcd mode address; e.g., 1201 for 729 tape unit Al. 

EOT: End-of-Tape Flag 

EOT=0: No end of tape has occurred on this unit. 
EOT = l: An end of tape has occurred while writing 
on this unit. 

DO: Tape Density at Load Point 
DO = 0: Low Density 
DO = l: High Density 

DI: Density at the Current Tape Position 
DI = : Low Density 
DI = 1: High Density 

Chain Address: This is the address of word 1 of the 
next unit control block in the availability chain. The 
chain address of the last unit is zero. This area is 
available to the user when the unit is not in the 
availability chain, or is not a reserve unit. 

Word 2 

S: Select Type 
S=0: Read 
S = l: Write 

R: Permanent Redundancy Message (control) 
R=0: A message is printed if a permanent read 

redundancy occurs. 
R = l: No message is printed in the event of a per- 
manent read redundancy. 

SEL: Select Routine 

sel represents symbolically the location of a user's 



select routine, which initiates data transmission and 
the posting of completed input/output activity. 

Word 3 

N: Noise Record Flag (reading only) 

N = 0: No noise records have been detected while 

reading. 
N = 1 : One or more noise records have been detected 

while reading. 

File Count: The file count reflects the number of file 
marks written on or read from this tape. 

Record Count: The record count reflects the number of 
records which have been written on or read from the 
current file. 

Word 4 

This word is provided for all-purpose systems usage. 
It is specifically used by iocs labeling routines for 
storing the tape reel serial number in case of multifile 
reels. 

Notes 

The eot flag and noise record flag are turned off only 
when the tape is returned to the rewound position. 

The record count is complemented when back- 
spacing from an end of file. A backspace which re- 
positions in front of a file mark gives a record count 
( 18-35 ) of 777777 8 . For example, when writing occurs 
from such a position, the two low-order tag bits are 
cleared to prevent a spurious increase in the file count 
when the record count is increased. 

The shaded area in Figure 9 is available to iocs, or 
any subsystem using ioex only. 

Disk Unit Control Block 

Each 1301/2302 Disk Storage Module is represented in 
ioex by a four-word unit control block whose format 
is shown in Figure 10. 
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Figure 10. Disk Unit Control Block 



The contents of each unit control block are inter- 
preted as: 
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Word I 

This word has the same interpretation as for word 
1 of the 729 tape unit control block except that when 
a disk module is attached to the channel, the System 
Monitor does not remove its unit control block from 
the availability chain even though it is assigned a sys- 
tem unit function. However, if input/output is per- 
formed on the unit by a subsystem which uses iocs, 
the chain address of word 1 will be modified, thereby 
destroying the availability chain for the channel until 
it is re-established at the next $job or srestore card. In 
general, the availability chain on a disk channel is of 
limited use, since unit assignment is based on cylinders 
rather than modules. Also, if the 7631 File Control Unit 
is a Model in or iv, bit position T will be one ( T = 1 ) ; 
otherwise, position T equals zero (T=0). 

The disk unit address has the format shown in Fig- 
ure 11. 
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Figure 11. Format of Disk Unit Address 

Examples: 

Channel C, 1301 Disk, Access 0, Module 1, Data 

Channel Switch Setting 1: address is (3101) 8 
Channel E, 2302 Disk, Access 1, Module 9, Data 

Channel Switch Setting 2: address is (5771) 8 

Word 2 

The interpretation of this word is the same as for 
word 2 of the 729 tape unit control block except that 
redundancy message control is not provided. Any disk 
error will produce an on-line message if recovery is 
unsuccessful. 

Word 3 

AF: Seek Request Flag 

AF=0: No seek is requested, or an attention sig- 
nal was received on the previously re- 
quested seek. 

AF = 1: A seek is requested by the user, or a seek 
was issued and an attention signal is 
awaited. This flag is set to 1 by the user 
when a seek is requested. It is reset to 
by ioex when the attention signal is re- 
ceived. 
PF: Seek Issued Flag ( used by ioex only ) 

PF = : No seek was issued . 

PF = 1: A seek was issued and an attention signal 
is awaited. 
Seek Order: The six bytes of word 3 and the first two 

bytes of word 4 are used to form the seek order 



for any seek requested of ioex by the user. The last 
two bytes of word 3 and the first two bytes of word 
4 will contain the track address (in bcd) for the 
desired seek. 

Word 4 

T: Track Flag 
T=0: ioex will set up the bcd track address for a 
requested seek, obtaining its information 
from the binary track address specified by 
the user in the address of word 4. 
T = l: The user, on requesting a seek, has already 
set up the bcd track address in words 3 and 
4. T is reset to zero by ioex after the seek 
is issued. 
Desired Seek Address: This is the track address (bi- 
nary ) for a seek requested by the user. The address 
of word 4 is never destroyed by ioex. 

Drum Unit Control Block 

Each 7320 Drum Storage unit is represented in ioex 
by a four-word unit control block, which is identical 
in format and usage to a Disk ucb except for the unit 
address in bits 5 through 17 of word 1. 

The drum unit address has the format shown in 
Figure 12. 



■89- 



12 



13 



14- 



■17 



Channel 
(1 through 8) 


Device 
(3 for drum) 


Data 
Channel 
Switch 
(Oor 1) 


Access 
(0) 


Module 
(0, 2, 4, 
6, or 8) 



Figure 12. Format of Drum Unit Address 

Examples: 

Channel C, Access, Module 0, Data Channel Switch 

Setting 0: address is (3300) 8 
Channel F, Access, Module 8, Data Channel Switch 

Setting 1: address is (5350) 8 

Hypertape Unit Control Block 

Each Hypertape drive is represented in ioex by a 
four-word unit control block with the format shown 
in Figure 13. 
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Figure 13. Hypertape Unit Control Block 
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The Hypertape unit control block is similar to the Word J 

unit control block for 729 tapes. The differences be- Unit Address: The unit address field for Hypertape 

tween a Hypertape unit control block and a 729 tape is similar to that for disk storage. It has the format 

unit control block are as follows: shown in Figure 14. 
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Figure 14. Format of Hypertape Unit Address 

Examples: 

Channel C, Hypertape Drive 1, Data Channel 

Switchsettingl=(3001) 8 
Channel H, Hypertape Drive 9, Data Channel 

Switch setting 2=(10051) 8 

EWA: End Warning Area Flag 

ewa = 0: The unit is not in the ewa. 

ewa = 1: The unit is or has been in the ewa. 

The ewa flag is turned off only when the tape is 

returned to the bot marker; or whenever hccr, 

hchc, or hunl is executed. 

Word 2 

R: Select Mode Flag 
R = 0: Normal select 
R = 1 : Select for backward reading 
Both this bit and the S bit are set by the user. 

Word 3 

AF: af Flag 

PF: pf Flag 

These flags are used only by ioex to control the use 
of Attention servicing routines. 

General Use of IOEX and Unit Control Blocks 

The following steps describe the general procedure 
to be taken by the user when input/output activity 
for a unit is desired. 

Before activity can be requested on an input/output 
unit, the user must determine whether or not the unit 
is free for use. This is accomplished by waiting for 
word 2 of the unit control block to become zero. Once 
it becomes zero, the user must assume control of the 
unit by placing the location of his select routine in the 
decrement of word 2. The user is also responsible for 
setting bit positions S and R in unit control block 
word 2. R is omitted for direct access storage units. 

After the input/output unit is secured for use, the 
user may request channel activity for the unit by 
entering the ioex routine .actv. This routine, which 
is used to handle data select activity, permits all nec- 
essary entries into the user's specified select routine 
as soon as the channel is free to accept input/output 
activity from the unit. Non-data select activity is 
handled by the routine .ndsel. 

On the first entry to the select routine, called the 
(sel+ ) or select entry, the user must initiate execu- 
tion of the input/output commands for the unit. 



Termination of the commands must always set up 
a trap condition for the cpu. 

On the last entry to the select routine, called the 
(sel— ) or posting entry, input/output activity for the 
unit is complete. At this time the user may relinquish 
control of the unit by setting word 2 of the unit con- 
trol block to zero, or he may choose a number of 
other options using information described under 
"Posting Entry." 

The user distinguishes between (sel+ ) and (sel—) 
entries to his select routine by testing the sign of the 
accumulator at time of entry. 

Normally, any direct reference to a unit control 
block at other than trap (sel) time should be trap- 
protected by the sequence: 

ENB L(0) 



ENB< 



.TRAPX 



Data Transmission Via Select Routine 

The initiation of data transmission operations for a 
unit, and the maintenance of any request queue for a 
unit, is the responsibility of the user of ioex. These 
functions must be provided in a subroutine, labeled sel 
for example, which is entered twice for each data 
transmission operation that results in a trap. The calling 
sequence from ioex is: 



TSX 



Return 1 

Return 2 
Return 3 



SEL,4 



Normal return at either 
entry 

Returns used at (SEL — ) 
time because of errors 
indicated. ( See appro- 
priate recovery section.) 

Upon either entry to the select routine, ioex disables 
channel trapping and provides : 

C(IR1) 

S(AC) 



The 2's complement of channel index (0=A, 
1 = B, etc.) 

Sign of accumulator: plus for (SEL+) and 
minus for (SEL— ) 
A (AC) Location of the unit control block 



Select Entry 

If the sign of the ac is plus on entry to sel, the routine 
must initiate a data selept command sequence terminat- 
ing in a trap. Traps must not be enabled by ( sel + ) . 
This is taken care of by ioex. For 7909 channel opera- 
tion, the command sequence should terminate with a 
TCH SYSTWT 

which will produce the necessary trap. In addition, 
an sms command which disables attention interrupts 
and enables unusual end interrupts must initiate the 
command sequence. 

For Hypertape, on each entry to the ( sel + ) routine, 
the user must initiate a data select command which will 
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read or write one record. This restriction which is 
similar to the restriction on the use of 729 fc. oe units, 
is necessary to ensure the correct record count ,'n word 
3 of the unit control block. 
Posting Entry 

If the sign of the accumulator is negative on entry to 
sel, a trap has occurred as a result of the previous 
select for the unit. The following information is fur- 
nished upon entry: 

Sense Indicators— 7607 Channel 
Bit S. Noise record flag 

1 The record was not an apparent noise record. 

The record was an apparent noise record. 
Bit 1 End of file (read) or end of tape (write) 

No end of file or end of tape. 

1 End of file or end of tape. 

Bit 2 Permanent redundancy (read only) 

No permanent redundancy. 

1 Permanent redundancy. 
Bit 3 Read or write indication 

Read. 

1 Write. 

Bit S is on in all cases except when a noise record 
is detected. 

Sense Indicators— 7909 Channel, Disk and Drum 
Bits S, 1-5 7909 Control counter 
Bit 6 Input/output check 

Bit 7 Sequence check 

Bit 8 UNUSUAL END 

Bit 9 attention on Interface 

Bit 10 attention on Interface 1 

Bit 11 Interface check 

Bits 12-35-First four bytes of the 7631 sense data. 
Bits 12-35 are supplied only if the trap 
was a result of an unusual end. In 
such a case, bit 8 will be a 1. 

Sense Indicators— 7909 Channel, Hypertape 

Bits S, 1-5 7909 Control Counter 

Bit 6 Input/output check 

Bit 7 Sequence check 

Bit 8 unusual end 

Bit 9 attention on Interface 

Bit 10 attention on Interface 1 

Bit 11 Interface check 

Bits 12-35 Bytes 1, 3, 4, 5, 6, and 7 (packed) of 
the 7640 sense data: supplied only if 
the trap was the result of an unusual 
end signal, i.e., if bit 8 is a 1. 
Ce// .COMM 

This word contains the results of a store channel in- 
struction for the 7607/7909 channel. If an unusual 
end condition occurs in the 7909 channel, the contents 
of.coMM will be overlaid with the contents of the 
address counter( 3-17) and the command counter( 21-35). 
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URRX,1 Table 

The urrx,i Table is used to keep a count of the number 
of redundancies on the channel. 

Redundancy Counts: 

PZE N1„N2 

Nl : Number of recovery entries to ( sel + ) . 

N2=0: No permanent redundancy (while read- 
ing) or no erase areas (writing). 
N2 = l: Permanent redundancy (reading) or one 
or more erase areas (writing). If a per- 
manent redundancy, N1=0. N2 is always 
zero for disk, drum, and Hypertape input/ 
output. 
The urrx,i Table may be referenced by indirectly 
addressing the communication cell .urrx. iri must 
contain the complement of the channel index. 

If eot ( or ewa if Hypertape ) is detected while writ- 
ing, the eot bit is set on in the unit control block, and 
the eot indication is given on each subsequent entry 
to (sel— ) for the unit until the tape is rewound. When 
an end-of-file indicator is given to ( sel — ) , the tape 
position has already been adjusted. The communication 
location .ltpos contains the tape position prior to this 
adjustment. A redundancy indication cannot occur to- 
gether with an end-of-file indication. 

Design of Select Routines 

Select routines must not destroy the contents of iri. 
ir2 and the sense indicators need not be saved. They 
must not modify or change the unit address in word 1 
of the unit control block or the four high-order bytes 
(except the sign bit) of word 3 of a direct access 
storage unit control block. 

In disk and drum usage, the select routine must 
interpret word 1 of the unit control block if use of 
the compact access and module bits are needed for 
setting up Prepare to Verify orders, or it must use 
.fdamt. (See "Form Disk/Drum Order" under "ioex 
Utility Routines.") 

Select routines should be designed to minimize proc- 
essing time while the machine is trapped. 



Unit Priority on a Channel 

Channel Priority Location 

When activity begins on a unit of a given channel, 
ioex places the address of the unit control block in a 
channel priority location. This allows the unit to retain 
priority until all its waiting operations have been com- 
pleted, ioex clears this location when the user clears 
word 2 of the unit control block. 

Upon a normal return from a ( sel — ) routine, ioex 
selects the next unit to be activated by examining the 
channel priority Cell. The same unit will be reselected 
if control was not relinquished by the user by clearing 
word 2 of the unit control block. 



Use of Channel Priority Location 

If the channel priority location is not zero, its address 
portion is interpreted as the location of the unit control 
block for the unit to be activated next. Word 2 of the 
unit control block is then tested. 

If word 2 is not zero, ( sel + ) for the unit is entered. 
If it is a direct access storage unit control block, the 
( sel + ) entry is held up ( return is still made to the 
user) until any pending seek for the unit has been 
issued and attention received. 

If word 2 of the unit control block is zero, the priority 
cell is cleared and the channel is scanned for a waiting 
unit, a unit that has a sel routine specified in word 2 
of its unit control block. In addition, if it is a unit 
control block for direct access storage, the af flag in 
word 3 must be zero. If a waiting unit is found, the 
location of its unit control block is placed in the chan- 
nel priority cell, and ( sel + ) is entered for the unit. 
If none is found, the channel is allowed to become 
dormant. In the case of a direct access storage unit, 
however, any pending seeks are issued, and the chan- 
nel becomes dormant only if no seeks are waiting to 
be issued. 



Activating a Channel and/or Assigning Priority 

A channel which is dormant is activated, or a unit is 
given top priority on a channel, by means of the rou- 
tine .actv. The calling sequence is: 

TSX .ACTV,4 

P A,T 

return 

where the parameter a, t gives the address of a loca- 
tion (possibly a System Unit Function Table entry) 
which contains: 

OP UCB,X,Y 

ucb is the address of the unit control block of the unit 
desiring input/output activity, op, x, and y are ignored 
by .actv. Note the double indirectness to the actual 
unit address. 

When p is pze in the calling sequence, controls are 
set up so that the user's select routine is entered when- 
ever the channel is free to accept activity on the 
specified unit. From the discussion under "Unit Priority 
on a Channel," it is obvious that no action by .actv 
is necessary if the channel is active upon entry. If 
such is the case, control is immediately returned to the 
user. 

If the channel is dormant, .actv enters the user's 
(sel+) routine directly before returning. In direct 
access storage, the af flag in word 3 of the unit con- 
trol block must be zero for (sel+ ) to be entered. If 
the af flag is not zero, .actv first activates the channel 
by issuing a seek for the access and for any other ac- 
cesses on the channel requesting the issuance of a 



seek. The select routines are entered as the attention 
signals are received. 

This entry to .actv, requesting the issuance of seeks 
(p=pze), is the only entry to the routine which does 
not require a sel routine to be specified in word 2 
of the unit control block. In such a case, .actv will 
still issue all requested seeks. This allows the user, 
if he so desires, to use "seek time" with the knowledge 
that the seek attention signal will be recorded when 
received by ioex but that no select routine for the 
unit will be entered. When the user is ready to have 
the select routine entered, he places its location in 
word 2 of the unit control block and, to ensure that 
the channel is activated if it became dormant, re- 
enters .actv with the af flag equal to zero. To deter- 
mine if a direct access storage unit is free for use 
when this option is exercised, the user must test the af 
flag as well as word 2 of the unit control block for zero. 

When p is mze in the calling sequence, the indi- 
cated unit is given top priority on the channel; that 
is, the channel priority cell is set for the unit, and 
( sel 4- ) is entered as soon as possible. If the entry 
to .actv is made during non-trap time, control is not 
returned to the user until the (sel+) entry for the 
unit has occurred. In direct access storage usage, if 
the af flag in word 3 of the unit control block equals 
one (af=i), the necessary seek is issued prior to the 
( sel + ) entry. 

If the entry to .actv is at trap time, e.g., during 
(sel— ), the unit is given top priority by the setting 
of the channel priority cell. However, return is made 
immediately. Hence, a subsequent entry to .actv re- 
questing priority (p=mze), cancels the priority effects 
of the previous entry if it occurs before (sel+ ) is en- 
tered for the previous entry. 

Any entry to .actv at trap time must be made with 
mze in the calling sequence, i.e., p=mze. Also, the entry 
must be for a unit connected to the channel that caused 
the trap. 

The .actv routine always enables traps on all chan- 
nels upon return, unless entry is from a select routine. 

.actv may not be entered during ( sel + ) time. 

.actv makes a validity test on the specified input/ 
output unit. To be valid, the specified location of the 
unit control block must fall within the range of core 
storage provided for all unit control blocks. In addi- 
tion, the A flag of word 1 of the unit control block 
must be zero. If a unit is judged to be invalid by these 
criteria, an automatic post-mortem dump is taken 
after the following message is printed on the System 
Printer: 

ILL UNIT REQ'ST AT xxxxx 

After the dump is taken, the System Supervisor 
skips to the next job segment. 
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In fap, the above validity test may be bypassed by 

using: 

TSX ( ACTVX.4 
in lieu of: 

TSX (ACTIV,4 

in the calling sequence, (activ being the fap equivalent 

of .ACTV. 

The routine .actv has the same purpose and use 
for Hypertape as it has for 729 tape units. Namely, 
upon entry to .actv, a sel routine must be specified 
in the appropriate unit control block. Entry is essen- 
tially a request by the user for input/output activity 
for the unit indicated in the calling sequence. 



Non-Data Selects 

Non-data selects are executed by the routine .ndsel. 

The calling sequence is: 

TSX .NDSEL 

PZE A,T,NDS 

return 

The parameter a,t has the same meaning as in the 
calling sequence for .actv. nds is interpreted for 729 
tape units as follows : 



NDS = 


NOP 


NDS = 1 


SDNL 


NDS = 2 


SDNH 


NDS = 3 


REW 


NDS = 4 


RUN 


NDS = 5 


BSR 


NDS = 6 


BSF 


NDS = 7 


WEF 



.ndsel gives the specified unit top priority by using 
.actv with mze in the calling sequence, i.e., p=mze. 
Hence, the non-data select is executed as soon as the 
unit's present activity is complete. Return is made only 
after the non-data select has been executed .ndsel may 
not be entered during (sel + ) time. 

The .ndsel routine always enables traps on all 
channels upon return unless entry is from a select 
routine, .ndsel may be entered at trap time only for 
a unit which is on the channel that has trapped. Non- 
data selects for card, disk, and drum equipment are 
ignored. 

.ndsel does a validity test on the specified unit 
control block in the same manner as .actv. In fap, 
the test may be bypassed by using tsx (ndslx rather 
than tsx (ndata. Note that a nop (nds=o) entry to 
.ndsel will have the effect of performing a validity test 
and nothing else. Backspacing a record across the 
previous file mark complements the record count in 
bits 18-35. 

wef causes the following sequence to be executed: 

WEFX 
TCOX* 
TRCX 
ETTX 



Recovery is attempted if a redundancy occurs while 
writing an end-of-file mark. The tape is backspaced, 
and the file mark is rewritten and checked as often as 
necessary. If the eot condition is detected on 729 
tape after a nonredundant end of file, return is made 
to 2, 4. The normal return for WEF is 3, 4. 

Hypertape orders are also handled by the .ndsel 
routine. The calling sequence is: 

TSX .NDSEL.4 

PZE A.T.NDS 

return 
The parameter a, t is the same as for 729 tape units. 
nds is interpreted as follows: 

NDS = NOP ( ( NDATA NOP ) 

NDS = 28 HCCR-Change Cartridge and Rewind 

NDS = 30 HRWD-Rewind 

NDS = 31 HRUN-Rewind and Unload 

NDS = 32* HERG-Erase Long Gap 

NDS = 33* HWTM-Write Tape Mark 

NDS = 34* HBSR-Backspace Record 

NDS = 35* HBSF-Backspace File 

NDS = 36* HSKR-Skip Record 

NDS = 37* HSKF-Skip File 

NDS = 38 HCHC-Change Cartridge 

NDS = 39 HUNL-Unload 

NDS = 42 HFPN-File Protect On 

Those orders marked with an asterisk are handled 
in the same way as non-data selects for 729 tape units. 
That is, the .ndsel routine uses .actv+i with an mze 
in the calling sequence. Hence, the order is executed 
as soon as the unit's present activity is complete. Re- 
turn is made from the .ndsel routine only after the 
order has been executed. 

The remaining orders will cause an attention signal 
upon completion of the operation. They are treated 
in the following manner: After any present activity 
is finished, ioex executes the order by specifying a 
select routine. Upon receiving the applicable attention 
signal, ioex clears word 2 of the unit control block. 
The user must not ask for new activity on that unit 
until word 2 is cleared. 

All orders must be given through the .ndsel routine. 
The return from the .ndsel routine is always to 2, 4. 
Entry to the .ndsel routine during trap time is per- 
mitted only for those Hypertape orders marked with 
an asterisk, and for those units on the same channel 
and Data Channel Switch setting as the unit which 
trapped. 

Redundancy Recovery 

Writing on 729 Tapes 

The redundancy trapping mode is used for a write 
operation. If the first attempt to write a record produces 
a redundancy trap, the following procedure is followed: 

1. The tape is backspaced one record. 

2. An erase area is written. If this operation pro- 
duces a redundancy check, an operator message is 
printed. 
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3. The record is rewritten (that is, (sel+) is en- 
tered) and checked for redundancy. 

4. Steps 1-3 are repeated until the .record is written 
correctly or the eot condition is sensed. After each 
group of 25 erase operations, an operator message is 
printed. 

ioex stops when the eot condition occurs during 
redundancy recovery. However, there is always at least 
one erase-rewrite sequence attempted, and, if the 
rewrite is successful, the stop does not occur. 

If, following the successful writing of a record, ioex 
determines that the apparent record length was less 
than three words, an entry is made to ( sel — ) with 
the noise record condition indicated in the sense indi- 
cators. Two exits are available for this condition: 

Return 1 The record is accepted. 

Return 2 The record is accepted, and an operator mes- 
sage is printed indicating that a short record 
has been written. 

The record count is increased before entry to 
( sel — ) . It is not increased before rewrite entries to 
(sel+ ). 

On each rewrite entry to ( sel + ) during redundancy 
recovery, urrx,i has the following configuration: 
PZE N„l 

where N is the number of consecutive erase areas which 
have been written. Following a successful redundancy 
recovery, on entry to (sel—), urrx,i has the same 
configuration. N in this case is the total number of 
erase areas written on this recovery. 

Reading from 729 Tapes 

The redundancy trapping mode is not used during 
read operations so that a full word count of record size 
may be secured. If the redundancy occurs as the result 
of a reading operation, the following steps are taken: 

1. If the record is an apparent noise record, (sel— ) 
is entered with appropriate indication in the sense indi- 
cators. If the record is not an apparent noise record, 
step 2 is taken. 

2. The redundancy count (address of urrx,i) is 
increased by 1. It is initially zero. 

3. If all of the following three conditions exist, a 
tape cleaner action is taken. If one or more conditions 
do not exist, step 4 is taken. 

a. The redundancy count is 1 or a multiple of 10 
plus 1. 

b. The noise record bit in word 3 of the unit con- 
trol block is off. 

c. There are at least two previous records in the 
current file. 

The tape cleaner action consists of backspacing over 
the redundant record and the two previous records, 
giving two dummy reads, and then entering (sel+) 
to reread the redundant record. 



4. The tape is backspaced over the redundant record, 
and (sel+ ) is entered to reread the redundant record. 

5. Steps 1 through 4 are repeated until the record 
is read correctly or until the redundancy count reaches 
the value of the assembly parameter rdunrt. If the 
value of rdunrt is reached, a permanent read re- 
dundancy is assumed. If such is the case, the record 
count is increased by one and an operator message is 
printed if not suppressed by the control bit in word 2 
of the unit control block. In addition, the instruction: 

PZE 0„1 

is stored in urrx,i, and (sel—) is entered with the 
permanent redundancy indication in the sense indi- 
cators. 

Read redundancy checking and recovery may be 
suppressed by setting rctx,i to zero in (sel + ). The 
rctx,i Table may be referenced by indirectly ad- 
dressing the communication location .rctx. iri must 
contain the complement of the channel index. On every 
entry to (sel+ ), rctx,i is set on (to nonzero). 

Exits from (SEL-) for 729 Tapes 

Three exits are available for ( sel — ) . 

Return 1 The record is accepted. 

Return 2 The record is considered noise and is dis- 
carded. An operator message is printed, and 
the noise record bit is set on in word 3 of 
the unit control block. The record count is 
reduced by 1; URRX,1 is cleared, and (SEL + ) 
is re-entered to read the next record. 

Return 3 The redundancy recovery procedure is en- 
tered at step 2. 

After each successfully completed write operation, 
and after a redundant read operation, the following 
test is made for an apparent short (noise) record. The 
address of the last input/output command is sub- 
tracted from the address of the Store Channel word 
to obtain an apparent word count. If this word count 
is less than three, ioex gives the noise record indication 
to (sel— ). 

Obviously, there are sequences of input/output 
commands which will produce this noise record condi- 
tion, even when the true record length is greater than 
two words. 

No test is made for use of the indirect addressing 
feature of input/output commands. If this feature 
is used, a short record will not be detected. 

Reading and Writing Disk and Drum 

Figure 15 is a table showing the bit assignments for 
the first four bytes of the 7631 sense data. When an 
unusual end signal occurs for a condition indicated 
in bytes 3, 4, or 5 of the sense data, ioex takes the 
following recovery action. 

Recovery Action 

If the unusual end occurred during a read or write 
on a disk, (sel+) is re-entered up to four times. 
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Byte 


Bit 


Assignment 


Abbre- 
viation 


Comment 


1 


2 


Reserved 


— 


Summary 
Bits 


4 


Program Check 


PRGCK 


5 


Data Check 


DATCK 


6 


Exceptional Condition 


EXCND 


2 


2 


Invalid Sequence 


I'SEQ 


Program 
Check 


4 


Invalid Code 


I'CDE 


5 


Format Check 


FRMCK 


6 


No Record Found 


NOREC 


3 


2 


Invalid Address 


I'ADR 


Data 
Check 


4 


Response Check 


RSPCK 


5 


Data Compare Check 


DCOMP 


6 


Parity or Cyclic Check 


P/CCK 


4 


2 


Access Inoperative 


INOPR 


Excep- 
tional 
Condi- 
tion 


4 


Access Not Ready 


NTRDY 


5 


File Frame 
Circuit Check 


DKCRK 


6 


File Adapter 
Circuit Check 


CUCRK 



Figure 15. Bit Assignments for the First Four Bytes of the 7631 
Sense Data 



If the unusual end persists, two seeks are given to 
recalibrate the arm. This is followed by the original 
seek requested by the user. (sel+) is then entered 
again. If the unusual end still persists, (sel+) will 
be re-entered up to three more times. If success is not 
achieved, (sel— ) is entered with the proper indica- 
tion. 

If the unusual end occurred during a read or write 
operation on a drum, (sel + ) is re-entered up to four 
times. If the unusual end persists, (sel— ) is entered 
with the appropriate bits set in the sense indicators to 
indicate the error condition. 

Select Exits 

Whenever (sel—) is entered because of an unsuc- 
cessful recovery attempt, an operator message will be 
printed indicating the error. The message will have the 
following form: 

TT . TTrr jxDam/s) WRITE ERROR-TRCK OOtttt 
UN11 /xNam/sf(READ) 

xl,x2,x3, . . . ,x24 

where tttt is the last track "seeked" by ioex and xl, 
x2,x3,...,x24 are octal numbers representing all 72 bits 
of the two 7631 sense data words (Appendix C). 

In addition, the address portion of urrx.i will con- 
tain the total number of re-entries to (sel+) made 
in attempting to recover. On each entry to ( sel + ) , 
urrx,i will be zero or will contain the number of 
times ( sel + ) has been entered previously in attempt- 
ing to recover from an unusual end. 

The three possible exits from (sel— ) are: 

Return 1 Normal return. 
Return 2 Not to be used. 

Return 3 Re-enter (SEL+) and repeat the recovery- 
actions if necessary. 



On any entry to (sel+), 7631 checking may be 
qualified by an exclusion flag corresponding to the 
7631 sense data listed in Figure 15. 

Procedure to Qualify 7631 Checking 

Into cell rctx,i place a word of the following format: 

PZE FLAGWD 

where flagwd is the location of a word which is an 

exclusion mask to be tested by ioex prior to any error 

procedures. 

For example, set exclusion to ignore norec, rspck, 

dcomp, and p/cck. 

CLA FLBITS 

STO* .RCTX 



FLBITS PZE * + l 

OCT 060107000000 

The proper summary bit is set on ( to nonzero ) as long 
as it is desired to exclude at least one of the errors to 
which it refers. In the above example, exclusion of the 
norec error also necessitated the exclusion of its sum- 
mary (prgck) bit. On every entry to (sel + ), rctx,i 
will be initialized to zero. 

Reading and Writing Hypertape 

Figure 16 is a table showing bytes 1, 2, 3, 4, 5, 6, and 7 
of the 7640 sense data which have been packed into 
four bytes as shown in the left-hand columns. The 
table indicates the associated recovery action taken 
by ioex when an unusual end signal occurs other than 
on an order issued by the .ndsel routine. 

Action 1 

The ( sel + ) routine is re-entered. If the error persists, 
the ( sel — ) routine will be entered and the proper 
sense data will be in the sense indicators. 

Action 2 

The ( sel — ) routine is not entered with the error 
indication until the sequence hrsr (or hskr) — Enter 
(sel + ) is repeated ten times without success. 

Action 3 

An hbsr order followed by an herg order is executed. 
The (sel+) routine is then re-entered. If the same 
unusual end signal persists after ten re-entries to 
( sel + ) , the ( sel — ) routine is entered with the 
proper indication. 

Action 4 

An operator message is printed indicating the correc- 
tive action to be taken by the operator. Upon com- 
pletion of the necessary operator action, the (sel + ) 
routine is re-entered. 
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Byte 


Bit 


Assignment 


Abbreviation 


Recovery 
Action 


Comment 


RD 


WR 


1 


1 
2 
3 
4 
5 
6 


Operator Required 
Program Check 
Data Check 
Exceptional Condition 
Selected Drive Not Ready 
Selected Drive Not Loaded 


OPREQ 
PRGCK 
DATCK 
EXCND 
NTRDY 
NTLOD 


4 
4 


4 
4 


Summary 
Bits 


Operator Required 


Program 
Check 


2 


1 
2 
3 
4 
5 
6 


Selected Drive File Protected 
Not Used 

Invalid Order Operation Code 
Selected Drive Busy 
Selected Drive at BOT 
Selected Drive at EOT 


FILPR 

I'ORD 
DRBSY 
ATBOT 
ATEOT 


1 
1 
1 
1 


4 

1 
1 
1 
] 


3 


1 
2 

3 
4 
5 
6 


Correction Occurred 
Channel Parity Check 
Code Check 
Envelope Check 
Overrun Check 
Excessive Skew Check 


PARCK 
CDECK 
ENVCK 
OVRCK 
ESKCK 


2 
2 
2 
2 
2 


3 
3 
3 
3 


Data 
Check 


4 


1 
2 
3 
4 
5 
6 


Track Start Check 

Not Used 

Selected DR Read a Tape Mark 

Selected DR in EWA 

No Data Transmitted 

Not Used 


TRSCK 
NDTRN 


2 
2 


3 

** 
1 


Exceptional 
Condition 



When a tape mark is read, return will be made to the (SEL-) routine with the proper 
sense data in the sense indicators. The applicable unit control block will contain a 
zero record count, and the file count will be increased by one. In addition, location 
. LTPOS will contain word 3 of the unit control block, as it was before the tape mark 
trap occurred . 

When writing continues into the EWA, the (SEL-) routine will be entered with the 
proper sense data in the sense indicators. In addition, the appropriate bit in word 
1 of the unit control block will be set on. 



Figure 16. Recovery Action Taken on an Unusual End Signal 



Exits 

The three possible exits from the (sel — ) routine are: 

Return 1 Normal return. 
Return 2 Not to be used. 

Return 3 Re-enter (SEL+) and repeat the recovery 
actions if necessary. 

Whenever the (sel—) routine is entered with an 
unusual end signal, an operator message is printed 
indicating the error. The message will have the follow- 
ing form : 

UNIT xHk/s WRITE ERROR 

(READ) 
xl,x2,x3, . . . ,x24 

where xl,x2,x3,...,x24 are octal numbers representing 
all 72 bits of the two 7640 sense data words (Appen- 
dix D). 

As with direct access storage, 7640 checking may 
be qualified upon entry to the (sel+) routine by 
means of an exclusion flag corresponding to the packed 



7640 sense data shown in Figure 16. Thus, the user can 
specify with flag bits any unusual conditions which he 
may wish to ignore. For example: 



FLBITS 



CLA 
STO* 



PZE 
OCT 



FLBITS 
.RCTX 



* + l 
301720000000 



will cause ioex to bypass any recovery attempts if any 
one of the following conditions causes an unusual 
end signal: 

I'ORD 

DRBSY 

ATBOT 

ATEOT 

PARCK 

These exclusion bits will also prevent the printing 
of any on-line message which usually would follow 
one of the above errors. 
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Channel Control Tables 

The ( sel + ) routine can make use of the ioex Tables 
of Reset and Load Channel instructions and Start 
Channel (7909) instructions. This should be done 
indirectly through the communication locations 
.rchx and .stcxi. iri must contain the complement 
of the channel index. 

The form of the tables themselves is : 

RCHX RCHA ** STCX STCA 
RCHB ** STCB 

.RCHX contains PZE RCHX.l. 

.STCXI contains PZE STCX,1. 

If .rchx is used, the applicable address in the rchx 
Table must be set upon every entry to (sel+ ). 



IOEX Utility Routines 

The following are ioex utility routines that may be 
used by subsystems operating under control of the 
System Monitor. The routines .mwr, .punch, .cvprt, 
.pause, .paws, .bcd5r, and .bcd5x all enable trapping 
(except at trap time) upon exit. This trapping can 
be suppressed by the user by setting the address 
portion of the ioex Communication Table entry 
.enbsw to nonzero. The address must be reset to zero 
by the user. 

Message Writer 

Messages can be printed both on-line and off-line, 
using the subroutine .mwr. Off-line messages are 
actually printed by a separate subroutine, spout, 
which is called by .mwr when an off-line message is 
specified in the .mwr calling sequence, spout is 
stored in core storage locations sysend-199 through 
sysend. Therefore, if any subsystem uses spout, it must 
consider sysend-200 as the end of usable core storage, 
rather than sysend. 

The calling sequence for .mwr is: 



TSX 


.MWR,4 


PFX 


N 


P 


L1,T1,M1 + 512*SPR1 


P 


L2,T2,M2 + 512*SPR2 



P LN,TN,MN+512*SPRN 

If pfx=pze, the message is printed on-line and no 
reference to spout is made. A subsystem that destroys 
spout must specify pze whenever .mwr is used, pfx 
is interpreted as pze for any call to .mwr during 
(sel+ ) or (sel— ) time. 

If pfx=mze, the message is recorded both off-line 
and on-line. 

If pfx=mon, the message is recorded off-line only. 

N is the number of entries following the calling 
sequence. M words ( six characters each ) beginning in 



location l, t are converted and placed in the line image 
for printing. If p=pze, the image is taken to be com- 
plete and the line is printed. If p=mze, this line is con- 
sidered incomplete, and the l,t,m of the next calling 
sequence entry are used to continue building the image, 
beginning with the next print position to the right. 
If the number of words specified for a particular line 
is greater than 12, only the first 12 are printed on-line. 
The sense exit spr, if given, is activated either before 
or after the line is printed, depending on whether 
p equals mze or pze. (spout will ignore an spr ap- 
pearing in a word with p=mze. ) For spout, spr must 
be (single space), 1 (eject), or 4 (double space). 
To activate an exit before printing the first line, an 
entry of the form 

PZE **„512*SPR 
may be used. This prints a blank line, followed by an 
activation of the hub spr. The same entry with the pre- 
fix changed to mze may be used preceding another 
calling sequence word to activate the hub spr ( on-line 
only) without printing a blank line. 

.mwr can be used either at trap time or at non-trap 
time. Printing is immediate; that is, the printing opera- 
tion is started before the return from .mwr. Printing 
at trap time will be on-line only. 

Alphameric Punch 

The entry 

TSX .PUNCH,4 

with sequence similar to .mwr, excepting sense exits, 
provides for punching bcd cards on-line for accounting, 
etc. 

Error Pause 

The instruction 

TSX .PAWS,4 

causes a machine stop ( hpr — 1 ) after on-line printing 
of the message 

PRES STRT TO GO ON 
Pressing the Start key causes on-line printing of the 
message 

. . . CONTINUING 
and returns control to 1, 4. 

Operator Action Pause 

The instruction 

TSX .PAUSE,4 

causes a machine stop ( hpr — 1 ) after on-line printing 
of the message 

OPER. ACTION PAUSE. . . 
Pressing the Start key causes on-line printing of the 
message 
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. . . CONTINUING 
and returns control to 1, 4. 

BCD Zero Conversion 

The instruction 

XEC .IBCDZ 

replaces decimal zeros in the bcd number located in 
the mq with bcd zeros, i.e., 12 8 . A crq is peformed. 
This routine is used for making disk/drum orders only. 

Form Disk/Drum Order 

The following routine places amtttt disk or drum 

data into the location of a specified order. It also sets 

interface bits for sms and places rr (ha2) into the 

second word of the order. 

The calling sequence is: 

TSX .FDAMT 5 2 

BCI 1,00RR0B 

PZE DORDER,T 

return 

iR4 equals — l (ucb), and bytes 3 through 6 of the mq 
contain tttt head and track in bcd. dorder,t is the 
location of the disk/drum order, rr is HA2 identifier, 
and B is the mask for the 7909 sms command. Bit 35, 
i.e., the low-order bit of B, is set for interface selection 
by .FDAMT. t may be zero or iri. 



converts the binary number in the decrement of AC 
to its bcd equivalent. The results are located in the 
low-order end of the mq. The high-order mq char- 
acter is a bcd blank. Control is returned to 1,4. 

Binary to Decimal Conversion — AC Address 

The instruction 

TSX .DECVA,4 

has the same function as .decvd, except that the ad- 
dress portion of ac is converted. 

Binary to BCD Octal Conversion — MQ Decrement 

The instruction 

TSX .BCD5R,4 

converts the binary number in the decrement of mq 
to its octal equivalent in bcd code. The results are 
located in the low-order end of the ac. The high-order 
ac character is a bcd blank. Control is returned to 1,4. 

Binary to BCD Octal Conversion — S, 1 -1 4 of MQ 

The instruction 

TSX .BCD5X,4 

has the same functions as .bcdsr above, except that 
bit positions S, 1-14 of the mq are converted. 



Post-Mortem Dump 

The instruction 

TSX .STOP,4 

causes a transfer to the location sysdmp in the System 
Nucleus. A transfer to sysdmp causes a post-mortem 
dump of core storage followed by the skipping of 
cards on the system input file until a sibsys, sexecute, 
$job, or $stop card is encountered. 

Symbolic Unit Conversion 

The instruction 

TSX .SYMUN,4 

converts the unit address located in the decrement 
of the mq, i.e., ldq with the address of word 1 of the 
unit control block, to its bcd equivalent as it appears 
on a sattach card. The results, straddled by any nec- 
essary bcd blanks, are located in positions P, 1-35 of 
the ac upon return to 1,4. 

Binary to Decimal Conversion — AC Decrement 

The instruction 

TSX .DECVD,4 



Convert and Append Unit Designation to Message 

The words "unitxxxxxx," where xxxxxx is converted 
from the unit address in d(mq), i.e., ldq with the ad- 
dress of word 1 of the unit control block, can be ap- 
pended to a message by the calling sequence 

TSX .CVPRT,4 

PFX L,T,M+512*SPR 

return 

where pfx is interpreted the same way as the pfx 
directly following the tsx .mwr,4. The remainder of 
the control word, that is, l,t,m+512*spr, is interpreted 
the same as in the control words in .mwr. 

Freeing a Channel 

The user tests channel activity with the sequence 



ZET* 
TRA 



.CHXAC 

*-l 



iri must contain the 2's complement of the channel 
index ( = channel A, 1 = channel B, etc. ) . 

When the zet falls through, all activity on the chan- 
nel is complete, including any disk-seek, drum-seek, 
or Hypertape free-running orders. 
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MAP 


FAP 






Symbolic 


Symbolic 






Address 


Address 


IOEX Entry 


.ACTV 


(ACT IV 


TTR 


TEST 




(ACTVX 


TTR 


ACTIV 


.NDSEL 


(NDATA 


TTR 


TEST 




(NDSLX 


TTR 


NDATA 


.MWR 


(PROUT 


TTR 


PROUTO 


.PUNCH 


(PUNCH 


TTR 


PUNCHO 


.ENBSW 


(ENBSW 


HTR 


** 


.PAWS 


(PAWSX 


TTR 


PAWS 


.PAUSE 


(PAUSE 


TTR 


PAUSE 


.STOP 


(STOPX 


TTR 


SYSDMP 


.SYMUN 


(SYMUN 


TTR 


SYUNCV 


.DECVD 


(DECVD 


TTR 


BCVDEC-1 


.DECVA 


(DECVA 


TTR 


BCVDEC 


.CKWAT 


(CKWAT 


TTR 


CKWAIT 


.BCD5R 


(BCD5R 


TTR 


BCD5-1 


.BCD5X 


(BCD5X 


TTR 


BCD5 


.CVPRT 


(CVPRT 


TTR 


CVPRT 


.STOPD 


(STOPD 


TTR 


SYSDMP 


.CHXAC 


(CHXAC 


PZE 


CHXAC, 1 


.URRX 


(URRXI 


PZE 


URRX,1 


.RCTX 


(RCTXI 


PZE 


RCTX,1 


.RCHX 


(RCHXI 


PZE 


RCHX,1 


.TCOX 


(TCOXI 


PZE 


TCOX,l 


.TRCX 


(TRCXI 


PZE 


TRCX,1 


.ETTX 


(ETTXI 


PZE 


ETTX,1 


.TEFX 


(TEFXI 


PZE 


TEFX,1 


.TRAPX 


(TRAPX 


PZE 


(TRAPS 


.TRAPS 


(TRAPS 


OCT 


377 


.COMM 


(COMMM 


PZE 


** ** 


.LTPOS 


(LTPOS 


PZE 


/ f 


.IOXSI 


(IOXSI 


BSS 


1 


.CHPSW 


(CHPSW 


PZE 


** 


.TRPSW 


(TRPSW 


PZE 


** 


.FDAMT 


(FDAMT 


TTR 


FDAMT 


.SDCXI 


(SDCXI 


PZE 


SDCX,1 


.STCXI 


(STCXI 


PZE 


STCX,1 


.COMMD 


(COMMD 


PZE 


** 


.IBCDZ 


(IBCDZ 


CRQ 


DECRQ,,6 


.CHXSP 


(CHXSP 


PZE 


CHXSP, 1 



Function 

Activate Routine and Test 

Activate Routine Without Test 

Non-Data Select and Test 

Non-Data Select Without Test 

Message Writer 

Alphameric Punch 

Enable Switch 

Error Pause 

Operator Action Pause 

Post-Mortem Dump 

Symbolic Unit Conversion 

Binary to Decimal - AC Decrement 

Binary to Decimal - AC Address 

Checkpoint Wait 

Binary to BCD Octal, Bits 3-17 of MQ 

Binary to BCD Octal, Bits 1-14 and S of MQ 

Convert and Append Unit Designation to Message 

Post-Mortem Dump 

Channel Activity (Indirect Reference) 

Redundancy Count (Indirect Reference) 

Redundancy Control (Indirect Reference) 

Reset Load Channel (Indirect Reference) 

Channel Delay (Indirect Reference) 

Tape Redundancy Test (Indirect Reference) 

End Tape Test (Indirect Reference) 

End File Test (Indirect Reference) 

Current Traps Enabled (Indirect Reference) 

Current Traps Enabled 

Store Channel Results at Trap 

Tape Position Before Last Trap 

Sense Indicators at Trap 

Checkpoint Switch 

Trap Switch 

Form Disk/Drum Order 

SDCX Table (Indirect Reference) 

STCX Table (Indirect Reference) 

Store Channel Diagnostic Results 

BCD Zero Conversion 

Priority Switch Table 



Figure 17. ioex Communication Table 
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System Editor 



Function 

The function of the System Editor is to modify, add, 
delete, replace, or rearrange records of the ibsys Op- 
erating System in order to meet the requirements of a 
particular installation. The ibsys Operating System is 
located on one or more System Library Units. The 
System Monitor (ibsys) must reside on syslbi. The 
remaining subsystems and the System Editor may also 
reside on syslbi or may, if so desired, be split to re- 
side on syslb2, syslb3, and/or syslb4. The four system 
library functions may be assigned any combination of 
input/output devices ( 729 Magnetic Tape, 7340 Hyper- 
tape, or direct access storage). However, if a subsystem 
resides on direct access storage, the System Monitor 
( ibsys ) must also reside on direct access storage. Edit- 
ing may proceed from any type of input/output unit 
(729, 7340, 1301, 2302, or 7320) to the same or any 
other type of unit. 

The maximum record size that can be processed by 
the System Editor is 23,840-word records. 

When either a $ibedt card or a $execute editor card 
is read by the System Supervisor, the System Editor is 
called into core storage and control is relinquished to 
it. The System Editor then proceeds to read and proc- 
ess control cards on the system input file. 

When a new System Library is produced by the 
Editor, it is recorded on sysuti. It may be formed from 
a combination of input from the old System Library on 
syslbi or syslb2, from alteration cards on sysini and/or 
sysut2, or from records on any other specified System 
Unit. 

*EDIT Card 

Control information is transmitted to the System Editor 
by an *edit card. This control card is required for every 
edit run and must immediately follow the sibedt card 
or the $execute editor card, whichever is used, 
whether or not any options are specified on the con- 
trol card. The format of the *edit card is: 

*EDIT [SYSLB2][ j '™** J ][,MAP] 

!,xDam/s/ 
,xNam/s> 
,xHk/s \ 

The options on this control card are interpreted as 
follows: 

SYSLB2 This option specifies that SYSLB2 is to be edited. 

If no option is indicated, SYSLBI is edited. 
HIGH This option specifies the density setting of the new 

LOW System Library Tape ( on SYSUTI ) . If no density 

is specified, the density is the same as the old 

System Library Tape. 



MODS 



xDam/s 
xNam/s 
xHk/s 



MAP This option specifies that the names of the records 

and files on the new System Library be listed on 
the System Output Unit. 

This option specifies that the maintenance control 
cards (*MODIFY, *REPLACE, etc.) or OCTAL 
alteration cards that affected a record be listed 
before the record name on the list specified by the 
MAP option. If the MAP option is not specified, 
this option is nullified. 

If the IBSYS record is being edited to a new Sys- 
tem Library on disk, drum, or Hypertape, a load 
card is required; that is, a card is required which 
loads in the IBSYS record at initial start when it is 
placed in the card reader and the LOAD CARDS 
push button on the Operator's Console is pressed. 
When this option is present, a load card is 
punched out on the System Punch Unit at the 
end of the edit. The card loads the IBSYS record 
from the unit specified by xDam/s (disk) ,xNam/s 
( drum ) , or xHk/s ( Hypertape ) . No card is punched 
if no unit is specified. 

Any text in columns 55 through 72 of the *edit card 
is used as the heading of all printed output from the 
System Editor. 



Arrangement of Subsystems 

The arrangement of subsystems in the System Library 
is indicated in the System Name Table (sysnam) of 
the System Supervisor. The table is used by the System 
Supervisor to locate a subsystem when a sexecute card 
is read from the input file. There are two entries in the 
table for each subsystem, as follows: 



BCI 
PZE 



1, sysnam 

tfiles, index, nfiles 



In the first entry, sysnam is the name of the sub- 
system. It corresponds to the name on the sexecute 
card that calls the subsystem. In the second entry, 
tfiles is the number of consecutive files that make up 
the subsystem; index is the number 1, 2, 3, or 4, cor- 
responding to syslbi, 2, 3, or 4, respectively; and nfiles 
is the number of files the System Supervisor must skip 
before scatter-loading the first record of the subsystem. 
The System Monitor (ibsys) file is always the first file 
on syslbi, and the System Editor is normally the last 
file on syslbi. 

* PLACE Card 

The *place card is used to modify the System Name 
Table. It is the only control card that can cause a 
change in the System Name Table. 

Note: All *place cards must immediately follow the 
*EDiTcard. 

The format of the *place card is : 



7 
♦PLACE 



16 

sysnam [, tfiles, index [, order]] 
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The *place card causes a subsystem name and data 
concerning the location of the subsystem to be inserted 
into or deleted from the System Name Table. 

If the three arguments tfiles, index, and order are 
specified on the *place card, an entry is posted in the 
System Name Table for the subsystem specified by 
sysnam. The argument tfiles is the number of consecu- 
tive files that make up the subsystem; index is the 
number 1, 2, 3, or 4, corresponding to syslbi, 2, 3, or 4, 
respectively; and order is the order of the specified 
subsystem in the System Library Unit with respect 
to other subsystems. The ibsys file is not a subsystem, 
so an order of 1 is used to specify the first subsystem, 
regardless of whether the index is 1, 2, 3, or 4. 

If the argument order is omitted or zero and the 
arguments tfiles and index are included on the control 
card, the entry in the System Name Table will indicate 
that the specified subsystem is the last subsystem on the 
new System Library Unit. 

If the three arguments tfiles, index, and order are 
omitted from the *place card, the entry in the System 
Name Table for the specified subsystem is deleted. 

When editing to direct access storage, a System 
Loader Table (sltable), as well as the System Name 
Table, is maintained by the System Editor. When the 
System Library is on direct access storage, the System 
Supervisor refers to the System Loader Table, instead 
of the System Name Table, to locate a subsystem when 
a sexecute card is encountered. However, when edit- 
ing to direct access storage, the System Name Table 
must still be kept up to date, using the *place card. 
When editing from direct access storage to tape, the 
new System Library is generated in accordance with 
the System Name Table on the direct access storage 
and the System Loader Table is omitted. 

When the System Library is on direct access storage, 
the *place card may also be used to insert or delete 
home address ( HA2 ) identifiers. This use of the *place 
card is described in the section "Disk and/or Drum 
Editing." 



Maintenance of the System Name and Loader Tables 

The System Name Table is used by the System Super- 
visor and is, therefore, part of the ibsys record. When 
the System Supervisor is loaded into core storage, 
the System Name Table is loaded into locations 
sysorg through sysorg+99. When the System Editor 
is subsequently loaded into core storage, it is loaded 
so that it does not overlay the System Name Table. 
Therefore, the table is available for updating by the 



System Editor if any *place cards are read. When the 
ibsys record, which is the first record on tape, is ed- 
ited onto sysuti, the System Editor performs the fol- 
lowing steps: 

1. Examines the location syscor in the Communica- 
tion Region of the System Nucleus (refer to Appen- 
dix A ) to determine the current location of the System 
Name Table. 

2. Changes the table as specified by any *place 
cards. 

3. Transfers the updated table to the ibsys record 
that is going to be written on sysuti.- The table is 
placed in the new ibsys record, so that it will be lo- 
cated beginning at sysorg whenever the System Super- 
visor is loaded into core storage. 

When editing to direct access storage, the System 
Loader Table is automatically maintained by the 
System Editor. The System Loader Table is located 
at sysorg +107 through sysorg +946. The System Name 
Table is always maintained by the System Editor from 
information supplied by *place cards, regardless of 
whether the System Library is on disk, drum, or tape. 

Alteration Cards 

Standard System Library records are derived from two 
types of alteration cards: absolute column-binary and 
octal. 

Absolute Column-Binary Cards 

The absolute column-binary cards are the standard 22- 
word-entry type, illustrated in Figure 18. The data or 
instruction words, beginning with word 3 on the control 
card, are written on the System Library Unit in a stand- 
ard System Library record format that enables them 
to be loaded in sequential core-storage locations, begin- 
ning with the location specified in bit positions 21 
... 30 of word 1, 

Octal Cards 

The octal card format is as follows: 

1 7 16 72 

octloc j*OCT I word 1, word 2, . . . ,word n 

/ octal} 
The use of * in column 7 is optional. Each octal word 
must consist of 12 or fewer unsigned digits. When 
fewer than 12 digits are entered in a word, they are 
right-justified in the word. The octal words are sepa- 
rated by commas on the control card. The words will 
be written on the System Library Unit in a standard 
System Library record format that enables them to be 
loaded into sequential core-storage locations, begin- 
ning with the location specified by the octal ad- 
dress octloc. 
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23 


24 


000000 

11111111 

.22222222 
33333333 
44444444 
55555555 
6G666G6G 
77777777 
(8888888 
99999999 
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Word 
1 



Bit Positions 
S 

1 

2 

9 
11 

12-17 
21-35 

S-35 
3-24 



Contents 
Must be blank. 

Must be blank. 

If punched, the System Editor does not compute a check sum 
from card data for comparison with card's prepunched check sum. 

Must be punched. 

Must be punched. 

Count of words in the card, excluding words 1 and 2. 

Absolute loading address — the actual address of the core storage 
location where the first data or instruction word on this card is to 
be stored . 

Check sum — the logical sum (Add and Carry Logical Word) of all 
words in this card except word 2. 

Data or instruction words. 



Figure 18. Absolute Column-Binary Card Format 



Standard System Library Record Formats 

Before records are edited onto 729 tape, they are con- 
verted by the System Editor into a standard self- 
loading scatter-load format (shown in Figure 19) that 
enables them to be loaded by the System Loader in the 
Nucleus. The records may be converted from similar 
standard System Library records on disk, drum or 
Hypertape (shown in Figure 20), from column-binary 
alteration cards or card images, from octal alteration 
cards or card images, or from a combination of these. 
The System Loader uses the following input/output 
command sequence to load standard System Library 
records from 729 tape: 



IOCP 

xxxx 

TCH 



* + l„l 
*-2 



where xxxx is either an iocp or ioct command. 

Since the System Supervisor employs the System 
Loader to load the first record of a subsystem, it is 
mandatory that the first record be in the standard 
System Library format shown in Figure 19. A sub- 
svstem may also use the System Loader to load suc- 
ceeding records, provided the records are also in the 



standard System Library format. No iocp command 
used by the System Loader can have a word count 
greater than 37777) 8 or be in the non- transmitting mode 
(bit 19 on). No more than one record at a time may 
be loaded using the System Loader, since redundancy 
checking is performed and the instruction sequence 
bsr, rds is attempted 10 times, if necessary. 

Each subsystem consists of one or more files, each 
file consisting of one or more records. The first record 
of each subsystem must load the location systra, in the 
Communication Region of the Nucleus, with a transfer 
to the first instruction in the subsystem that is to be 
executed. This is necessary because the System Super- 
visor transfers control to systra after loading the first 
record of a subsystem specified on the sexecute card. 

The first word in a standard record, following the 
initial input/output command ( location loci in Figure 
19 ) , must be the name of the record in bcd form, with- 
out leading blanks. If a record is the first record of a 
file, the name of the record is also the name of the file. 
If the file is the first file of a subsystem, the name of the 
first record of the file is the name of the subsystem ( as 
specified in the System Name Table), as well as the 
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First command word 



Nl sequential words - 
Second command word 

N2 sequential words - 



Third command word 



N3 sequential words 



IOCP LOCl,,Nl 



BCI 



1.NAME 



IOCP 



LOC2..N2 



IOCP LOC3,,N3 



I IOCP LQCn,,Nn I 



Nth command word 
Nn sequential words - 
Last command word 



Figure 19. Standard System Library Record Format for 729 
Tape 




First command word — 
Nl sequential words — 
Second command word 

N2 sequential words — 



Third command word 



N3 sequential words 



' Nth command word 



Nn sequential words 



Last command word 



CPYP 


LOCI,, NT 


BCI 


1,NAME 




[ CPYP 


LOC2,,N2 | 




CPYP 


LOC3,,N3 | 


i 1 


! 1 

1 

1 i 

! i 
i i 
i i 
i i 
i i 


CPYP 


LOCn,,Nn 




I TCH 


SYSCYD 



* For an explanation of SYSCYD refer to Appendix A 

Figure 20. Standard System Library Record Format for Hyper- 
tape, Disk, and Drum 



name of the first file of the subsystem. When the System 
Library is being edited, the name of the first record of 
each subsystem in the new System Library is checked 
against the entry for the subsystem in the System Name 
Table. If a discrepancy exists, an error message is 
printed. 

The record name is the name printed when the map 
option on the *edit card is exercised. It is also used by 
the System Editor to identify a record, a file, or a sub- 
system. 

Note, however, that the System Supervisor locates a 
subsystem specified on a $execute card by referring to 
the System Name Table or, if the System Library is on 
direct access storage, by referring to the System 
Loader Table. The last record on a System Library 
Tape has the identification *eot and is used to inform 
the System Editor of the logical end of tape. 

When a subsystem or part of a subsystem is loaded 
into core storage, it must not overlay the System 
Nucleus. 

If the subsystem is not loaded into the area occupied 
by the Input/Output Executor (ioex) or the off-line 
writing routine spout, ioex and spout are immediately 



available for use by the subsystem. The off-line writing 
routine spout cannot be used if ioex is overlaid. 

Before records are edited onto Hypertape or direct 
access storage, they are converted by the System Editor 
into a standard System Library format ( shown in Fig- 
ure 20) similar to the format for 729 tape, that enables 
them to be loaded by the System Loader. The records 
may be converted from standard System Library rec- 
ords on 729 tape (shown in Figure 19), from column 
binary alteration cards or card images, from octal alter- 
ation cards or card images, or from a combination of 
these. The System Loader uses the following input/ 
output command sequence to load standard System 
Library records from Hypertape or direct access stor- 
age: 



CPYP 

xxxx 

TCH 



* + l„l 

** ** 

*-2 



where xxxx is either a cpyp or tch command. 

Since the System Supervisor employs the System 
Loader to load the first record of a subsystem, it is 
mandatory that the first record be in the standard 
System Library format as shown in Figure 20. 
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When loading standard System Library records from 
direct access storage, the cylinder mode of operation 
is used. A sample scatter-read program for reading rec- 
ords from disk is shown in Appendix E. 

When a record on direct access storage extends 
across two cylinders, the System Editor sets the last 
word on the first of the two cylinders to the following: 

TCH SYSCYD„yyy 

where yyy is the location of the first track of the second 
of the two cylinders. The remainder of the record on 
the second cylinder begins with an appropriate cpyp 
command. If editing proceeds from direct access 
storage to magnetic tape, any tch command within a 
record that was written because the record straddled 
two cylinders is reset by the System Editor to a cpyp 
command with a word count. 

In a disk or drum record, the low-order bits of the 
decrement in the final tch syscyd command points to 
the track origin of the next sequential record, and the 
high-order bit of the decrement is set to 1. The 1-bit 
indicates to the System Loader that the tch is the true 
end of the record and not just the end of a cylinder. 

Maintenance Control Cards 

The actual addition, deletion, rearrangement, or modi- 
fication of subsystems or records and files within a sub- 
system is performed by the use of the maintenance 
control cards described in this section. A *place card 
does no more than post, in the System Name Table, 
the position of a subsystem. The maintenance control 
cards must be in the same order as the records to 
which they refer. If a maintenance control card refers 
to a record out of sequence in the edit deck, the effect 
of the control card is nullified and a message is printed. 

* MODIFY Card 

The format of the *modify card is as follows: 

1 
[TAPE] 

where recnam is the name of a record in the old 

System Library (syslbi or syslb2) that is to be 

modified. 

If tape does not appear in columns 1-4, this control 
card causes the specified record to be consolidated 
with alteration cards that follow this control card on 
sysini. The alteration cards on sysini may be any com- 
bination of octal and column-binary cards. 

If tape appears in columns 1-4, the *modify card 
causes the specified record to be consolidated with al- 
teration cards on sysut2. The alteration cards on sysut2 
must be in the form of column-binary card images. 

The System Editor performs the following steps 
after reading a *modify card: 

1. Transfers to sysuti all files, file marks, and rec- 
ords on syslbi (or syslb2, if specified on the *edit 



7 16 

♦MODIFY recnam 



card) up to, but not including, the record specified on 
the *modify card. If necessary, records are converted 
to the standard System Library record format shown 
in Figure 19, when sysuti is 729 tape, or to the stand- 
ard format shown in Figure 20, if sysuti is Hypertape 
or direct access storage. 

2. Reads the specified record into core storage. 

3. Deletes the ioct or tch command at the end of 
the record. 

4. Appends an iocp (or cpyp) command of the fol- 
lowing form to the record: 

IOCP LOC„N 

where loc is the storage location specified in the first 
alteration card and N is the number of words, con- 
tained on the first alteration card and the alteration 
cards immediately following it, that are to be loaded 
into contiguous core-storage locations. 

5. Places the N words from the alteration cards into 
the record following the newly appended command 
word. 

6. Repeat steps 4 and 5, with appropriate loc and N 
values, until, if tape is specified, a transfer card is en- 
countered on sysut2 or, if tape is not specified, until a 
new System Editor control card is encountered on 

SYSINI. 

7. Appends, to the end of the record, an ioct com- 
mand with a word count of zero or, if sysuti is Hyper- 
tape or direct access storage, a tch syscyd command. 

8. Writes the expanded record onto sysuti. 
After all actions required by the *modify card are 

completed, syslbi (syslb2) will be positioned just 
after the specified record and before the next record 
( or file mark, if not a record ) . 

♦REPLACE Cord 

The format of the *beplace card is as follows: 

1 7 16 

nFILE M * REPLACE jrecnam [ , S YSxxx 
TAPE} J jsysnaml' 

If neither tape nor file appears in columns 1-4, the 
*replace card causes an entire record (specified by 
recnam ) in the old System Library on syslbi ( syslb2) 
to be replaced on sysuti, with a new record formed 
entirely from the alteration cards that follow the 
*replace card on sysini. If tape appears in columns 
1-4, the specified record is replaced by a new record 
formed from the alteration cards on sysut2, rather than 

SYSINI. 

Before the specified record is replaced, all of the 
files, file marks, and records that precede the record on 
syslbi (syslb2) are transferred to sysuti. The replace- 
ment record represented by the alteration cards and, 
if necessary, the records transferred from syslbi 
(syslb2) are converted to the standard System Library 
record format shown in Figure 19 if sysuti is 729 tape, 
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or to the standard format shown in Figure 20 if sysuti 
is Hypertape or direct access storage. 

The alteration cards on sysut2 must be column- 
binary card images when tape is specified. When tape 
and file are not specified, the alteration cards that 
follow the *replace card on sysini may be any com- 
bination of octal and column-binary cards. As with the 
♦modify card, the end of the alteration cards is sig- 
naled by a transfer card when tape is specified, or by a 
System Editor control card when tape and file are not 
specified. 

When all of the operations called for by the 
♦replace or tape *replace card are completed, syslbi 
( syslb2 ) is positioned just after the record specified by 
recnam, but before the next record or file mark. 

If file appears in columns 1-4 of the *replace card 
and the name appearing in columns 16-21 matches a 
subsystem name in the System Name Table, all rec- 
ords, files, and file marks are read in from syslbi 
( syslb2 ) and written out on sysuti, until the specified 
subsystem is located in accordance with the entry in 
the System Name Table. When the subsystem is lo- 
cated, it is replaced on sysuti by the files on sysxxx. 
If the number of files in the replacement differs from 
the original, a *place card reflecting this must be in- 
serted into the edit deck following the *edit card, but 
preceding the maintenance control cards. 

The first word of each record read from sysxxx is 
checked for an iocp ( or cpyp ) command. If it is not an 
iocp ( or cpyp) command, the record is considered non- 
standard and is duplicated without change onto sysuti. 
If it is an iocp ( or cpyp) command, the record is con- 
sidered a standard System Library record. In this case, 
the record is duplicated onto sysuti, except for the last 
word. The last word is changed to an ioct o„o com- 
mand if sysuti is 729 tape, or to a tch syscyd com- 
mand if sysuti is Hypertape or direct access storage. 
If sysut2 is a direct access storage unit, the required 
tch command is inserted whenever a cylinder bound- 
ary is crossed while a record is being written. 

If file appears in columns 1-4 of the *replace card 
and the name appearing in columns 16-21 does not 
match a subsystem name in the System Name Table, 
all records, files, and file marks are read in from syslbi 
( syslb2 ) and written out on sysuti, until a record with 
the specified name is located. When the specified rec- 
ord is located, it, and all succeeding records (if any) 
up to and including the next file mark, are replaced 
on sysuti by the next file and file mark on sysxxx. The 
replacement records are processed by the System Edi- 
tor as described in the preceding paragraph. To re- 
place an entire file, the record name specified on the 
file *replace card must be the name of the first record 
in the file. However, if the name of the first record in 
the file matches a subsystem name in the System Name 



Table, all of the files in the subsystem will be replaced, 
as previously described. 

When all actions required by the file *replace card 
are completed, syslbi (syslb2) is positioned after the 
file mark that follows the last file (or part of a file) 
replaced. 

* INSERT Card 

The format of the *insert card is as follows: 

1 7 16 

[TAPE] 'INSERT [FILEMK] 

If tape and filemk are not specified, the *insert 
card causes a new record, formed from octal and/or 
column-binary alteration cards following the *insert 
card on sysini, to be written on sysuti at its current 
position. The end of the alteration cards on sysini is 
indicated by a new System Editor control card. 

If tape appears in columns 1-4 and filemk is not 
specified, the new record is formed from alteration 
cards in the form of column-binary card images on 
sysut2. The end of the alteration cards on sysut2 is 
indicated by a transfer card. 

The new record, represented by the alteration cards 
on sysini or sysut2, is converted to the standard Sys- 
tem Library record format shown in Figure 19, if 
sysuti is 729 tape, or to the standard format shown in 
Figure 20, if sysuti is Hypertape or direct access 
storage. 

If filemk is specified, a file mark is inserted on 
sysuti at its current position. When sysuti is disk or 
drum, a flag, analogous to a tape file mark, is placed 
into a disk/drum record address area ( shown in Figure 
21 ) . A single *insert card cannot be used both to in- 
sert a new record and to write a file mark. 

The position of syslbi ( syslb2 ) is not changed by an 
♦insert card. 

* REMOVE Card 

The format of the *remove card is as follows: 

1 7 16 

[FILE] *REMOVE /recnam \ 

< sysnam > 
IFILEMKJ 

If neither file nor filemk is specified, the *remove 
card causes the record specified in columns 16-21 to be 
spaced over on syslbi (syslb2) and omitted from 
sysuti. Before the specified record is removed, all of 
the files, file marks, and records that precede the rec- 
ord on syslbi (syslb2) are transferred to sysuti. After 
the *remove card is processed, syslbi (syslb2) is 
positioned immediately after the specified record. 

If filemk is specified in columns 16-21, the next 
end-of-file mark encountered on syslbi (syslb2) is 
spaced over and omitted from sysuti. All records that 
precede the file mark on syslbi ( syslb2 ) are transferred 
to sysuti. syslbi (syslb2) ends up positioned immedi- 
ately after the file mark that was omitted from sysuti. 
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If file is specified and the name in columns 16-21 is 
a subsystem name in the System Name Table, all the 
files and accompanying file marks associated with the 
subsystem (as defined by the System Name Table 
entry ) are spaced over on syslbi ( syslb2 ) and omitted 
from sysuti. 

If file is specified and the name in columns 16-21 
is the name of a record, but not the name of a sub- 
system posted in the System Name Table, the specified 
record and all succeeding records (if any), up to and 
including the next file mark, are spaced over on syslbi 
(syslb2) and omitted from sysuti. If an entire file is to 
be removed, the name specified on the file *remove 
card must be the name of the first record in the file. 
However, if the name of the first record in the file 
matches a subsystem name in the System Name Table, 
all of the files in the subsystem will be removed, as 
previously described. 

Before a specified subsystem or record is removed, 
all of the records, files, and file marks that precede it 
on syslbi (syslbs) are transferred to sysuti. 

* AFTER Card 

The format of the *after card is as follows: 

1 7 16 

[FILE] *AFTER /recnam "| 

< sysnam > 

IfilemkJ 

If neither file nor filemk is specified, the *after 
card causes the reading of control cards to be sus- 
pended until all files, file marks, and records on syslbi 
(syslb2), up to and including the record specified in 
columns 16-21, have been transferred to sysuti. 

If filemk is specified in columns 16-21, the next file 
mark on syslbi (syslb2) and all records preceding it 
are transferred to sysuti. 

If file is specified and the name in columns 16-21 is 
a subsystem name in the System Name Table, all of 
the files, file marks, and records on syslbi (syslb2), up 
to and including the files and accompanying file marks 
associated with the specified subsystem (as defined 
by the System Name Table entry), are transferred to 

SYSUTI. 

If file is specified and the name in columns 16-21 is 
the name of a record, but not the name of a subsystem 
posted in the System Name Table, all of the £. x es, file 
marks, and records on syslbi (syslb2), up to and in- 
cluding the next file mark following the specified 
record, are transferred to sysuti. 

*DUP Card 

The format of the *dup card is as follows: 

7 16 

*DUP SYSxxx, SYSyyy, n 

This control card transfers n files from sysxxx to 
SYsyyy. The transfer proceeds up to and through the 



nth file mark read on sysxxx. If n is blank, 1, or 0, one 
file and the file mark following it are transferred to 
SYsyyy. 

If SYsyyy is sysuti, the transfer of files from sysxxx 
is performed as described for the file *replace card, 
as follows. The first word of each record of the files 
read from sysxxx is checked for an iocp (or cpyp) 
command. If it is not an iocp ( or cpyp ) command, the 
record is considered nonstandard and is duplicated 
without change onto sysuti. If it is an iocp (or cpyp) 
command, the record is considered a standard System 
Library record. In this case, the record is duplicated 
onto sysuti, except for the last word. The last word is 
changed to an ioct o„o command if sysuti is 729 
magnetic tape, or to a tch syscyd command if sysuti 
is Hypertape or direct access storage. If sysuti is direct 
access storage, the required tch command is inserted 
whenever a cylinder boundary is crossed while a 
record is being written. 

* REWIND Card 

The format of the *rewind card is as follows: 

7 16 

♦REWIND SYSxxx 

This control card rewinds the unit assigned to the 
specified system unit function. When the unit assigned 
to the specified system unit function is a direct access 
storage unit, the *rewind card causes the System Edi- 
tor to begin its next read or write operation on the 
unit at the load point defined by the parameters on the 
$as card when the unit was assigned to the specified 
system unit function. 

The *rewind card may be used to define the start- 
ing tape position or disk/drum load point before using 
a *dup card. The *rewind and *dup cards may be used 
to rearrange subsystems in the System Library or to 
incorporate, into the System Library, special-format 
records that have been previously edited by a sub- 
system. 

* CHECK Card 

The format of the *check card is as follows : 

7 16 

*CHECK count, oldnam, newnam 

This control card causes a test to be made to ensure 
that the correct number of editing cards were read 
and that the correct System Library tape was proc- 
essed. The argument count is the number of alteration 
cards and maintenance control cards, including the 
*check card, but not the *edit card. The argument 
oldnam is a name which is compared with the System 
Library name in the fourth word of the *eot record on 
syslbi ( syslb2 ) . If the two names are not the same, an 
error message is printed. The argument newnam is 
the name assigned to the new System Library (tape, 
disk, or drum) on sysuti. The arguments must appear 
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in the order given. If an argument is blank, the cor- 
responding operation is ignored. 

If more than one *check card is read during an edit 
run, only the last one is processed. 

* REMARK Card 

The format of the *remark card is as follows : 

7 16 

♦REMARK any remark 

This control card causes the characters in columns 
16-72 of the control card to be listed on the System 
Printer and the System Output Unit. 

The *remark card may not be placed between the 
control cards *modify, *replace, or *insert, and the 
alteration cards immediately following these control 
cards. 

Termination of Editing 

The System Editor completes the editing process when 
an end of file or a control card with a 7 and 8 punch 
in column 1 is encountered on sysini. The System 
Editor performs the following steps to terminate the 
editing process: 

1. Transfers from syslbi (syslb2) to sysuti all re- 
maining files, file marks, and records up to, but not 
including, the *eot record on syslbi (syslb2). 

2. Reads the *eot record from syslbi ( syslb2 ) and 
performs the tests and changes specified on the last 
*check card read. 

3. Writes the new *eot record and a file mark on 

SYSUTI. 

4. Rewinds syslbi (syslb2) and sysuti. 

The System Editor then reads the next card on 
sysini, expecting to find a sibsys, $job, sexecute, or 
$stop card. 

Disk and/or Drum Editing 

When editing to direct access storage, a System 
Loader Table, as well as the System Name Table, is 
maintained by the System Editor. When the System 
Library is on disk and/or drum, the System Supervisor 
refers to the System Loader Table, instead of the Sys- 
tem Name Table, to locate a subsystem when a 
sexecute card is encountered. However, when editing 
to direct access storage the System Name Table must 
still be kept up to date, using the *place card. The Sys- 
tem Loader Table is part of the ibsys record which 
must be the first record edited to direct access storage. 
Records which do not have an iocp or cpyp com- 
mand as their first word, containing the number of 
words following, are not included in the System 
Loader Table. A record is not considered to be a 
standard System Library record if it begins with any 
of the following commands: iort, iorp, ioct, iosp, or 

IOST. 

An end of record or an end of file is indicated on 
direct access storage by a flag in the record address 



Seek Chain 
Address 



"Pseudo" Record 
Count to simulate 
SCHx Instruction 



1 2 3- 



17- 



Figure 21. Format of Disk/Drum Record Address Area 

area. The format of a record address area is shown in 
Figure 21. An end of record is indicated by a 1-bit in 
bit position S and an end of file is indicated by a 1-bit 
in bit position 1. 

The System Editor writes using the home address 
operation. Disk writing is done in the 6-bit mode using 
a 465-word track format for 1301 disk and a 969-word 
format track for 2302 disk. A 524-word track format is 
used when writing on drum. Any 1301/2302 Disk 
Storage or 7320 Drum Storage used by the System 
Editor must have the Verify Cylinder feature. 

If an error occurs while editing to direct access 
storage, the format track, which was assumed good 
at the start, is rewritten to ensure its validity, and edit- 
ing continues. If a second error occurs on the same 
select request, editing continues, if possible, and the 
condition is ignored. 

When editing involves a direct access device, the 
hao switch on the ibm 7631 File Control must be on 
(up). To protect the System Library, a home address 
(ha2) identifier containing bmoooo is written on each 
track containing records of the System Library. The 
format key should be unlocked to enable the System 
Editor to rewrite format tracks. It should be locked 
again when the edit run is completed. 

The *place card may be used to insert or delete 
home address (ha2) identifiers. This use of the *place 
card is illustrated by the following examples. 

Example 1 

Starting with cylinder 10, write home address (ha2) 
identifiers of pq on 15 cylinders assigned to the spec- 
ified system unit function. 
1 7 16 

SYSxxx *PLACE PQ, 15, 10 

Example 2 

Reset to general use code 00 the home address (ha2) 
identifiers on 250 cylinders assigned to the specified 
system unit function beginning with cylinder 0. 
1 7 16 

SYSxxx *PLACE 00, 250, 

Care should be taken to ensure that the cylinder 
limits are defined correctly, since incorrectly defined 
limits may result in the destruction of valid data. 

Example 3 

If it is desired to write home address (ha2) identifiers 
on the cylinders assigned to a specified system unit 
function and to bypass subsequent editing, the follow- 
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ing *place card should be inserted in the edit deck, 
after all other *place cards and preceding the end- 
of-file card. 



1 
SYSxxx 



7 
♦PLACE 



Editing Relocatable Records 

If a standard relocatable record is located on SYSim 
when one of the following maintenance control cards 
is read, the System Editor converts it to a format 
similar to the standard System Library format. 



1 


7 16 


TAPE 


♦REPLACE recnam 


TAPE 


♦INSERT recnam 



Two iocp ( cpyp ) commands and a record name are 
placed at the beginning of the record by the Editor, 
as follows: 



IOCP 

BCI 

IOCP 



LOCl„l 
1,NAME 
LOC2„N 



where loci is 45000 8 , name is the record name speci- 
fied on the *replace or *insert card, loc2 is 45002 8 , 
and N is the number of words in the relocatable 
record. An ioct command with a word count of zero 
is appended to the record if sysuti is 729 tape, or a 
tch syscyd command is appended to the record if 
sysuti is Hypertape or direct access storage. 

Once a relocatable record is placed in the System 
Library in the standard System Library format, all 
maintenance control cards that are applicable to non- 
relocatable records in the standard System Library 
format, except the *modify card, are also applicable 
to the relocatable record. 

Editing Examples 

The following are examples of typical editing jobs that 
might be performed by the System Editor. 

Example 1 

The sample job deck in Figure 22 might be used to 
prepare a new 729 System Library Tape with correc- 
tions to record reci and complete replacement of 
records abc and xyz. 



editing example 2, a new System Library on channel 
C, disk module 1, Data Channel Switch setting 1. 

Example 4 

The sample job deck in Figure 25 might be used to 
rearrange the subsystems on a 729 System Library 
Tape so that the subsystem systma, consisting of two 
files located just after the ibsys file, will be reposi- 
tioned just after the subsystem systmx. Assume systmx 
is presently the last three files just before the Sys- 
tem Editor. 

1 7 16 



$JOB 

$IBSYS 

SIBEDT 



EDIT 
MODIFY 



729 TAPE TO 729 TAPE EDIT 



MAP, MODS 
RECI 



(•OCT AND/OR COLUMN-BINARY 
CARDS ON SYSIN1) 



TAPE "REPLACE ABC 

(COLUMN-BINARY CARD IMAGES ON SYSUT2) 
TAPE "REPLACE XYZ 

(COLUMN-BINARY CARD IMAGES ON SYSUT2, SEPARATED 
FROM ABC CARD IMAGES BY A TRANSFER CARD) 

(END-OF-FILE CARD) 
$STOP 

Figure 22. Sample Job Deck for Making Corrections to a 729 
System Library Tape 
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$JOB 




729 TAPE TO HYP 


$IBSYS 






$ATTACH 




CH2/1 


IAS 




SYSUTI 


$IBEDT 






• 


EDIT 


MAP, MODS, CHO/1 


• 


CHECK 


1,729SYS,HYPSYS 


(END 


-OF-FILE CARD) 


$IBSYS 







Figure 23. Sample Job Deck for Preparing a System Library on 
Hypertape from a 729 System Library Tape 



Example 2 

The sample job deck in Figure 23 might be used to 
prepare, from a 729 System Library Tape, a new 
System Library on channel C, Hypertape Drive 2, 
Data Channel Switch setting 2. The new System Li- 
brary Tape is to be used on channel C, Hypertape 
Drive 0, Data Channel Switch setting 2. 

Example 3 

The sample job deck in Figure 24 might be used to 
prepare, from the System Library Tape prepared in 
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LOAD USING HYPERTAPE LOAD CARD PUNCHED 
DURING JOB LISTED IN FIGURE 23 



iJOB 


HYPER TO DISK EDI 


MBSYS 




$ATTACH 


CD01/0 


»AS 


SYSUTI, 010, 222, 8M 


$IBEDT 




• EDIT 


CD01/0 


(END-OF- 


FILE CARD) 


$ST0P 





Figure 24. Sample Job Deck for Preparing a System Library on 
Disk Storage from a System Library on Hypertape 
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$JOB 

♦IBSYS 

$IBEDT 

•EDIT 

•PLACE 

•PLACE 

•AFTER 

•REWIND 

•DUP 
FILE »AFTER 

•REWIND 

•DUP 

(END-OF-FILE CARD) 
$IBSYS 



REARRANGE SYSTMA ON 729 SYSTEM LIBRARY TAPE 



MAP, MODS 

SYSTMA 

SYSTMA, 2,1 

FILEMK 

SYSUT4 

SYSLBI, SYSUT4, 2 

SYSTMX 

SYSUT4 

SYSUT4,SYSUT1,2 



DELETE OLD SYSTMA REFERENCE IN SYSNAM 
INSERT NEW SYSTMA REFERENCE IN SYSNAM 
POSITION SYSLB1 AFTER THE IBSYS FILE 
ENSURE SYSUT4 IS REWOUND 
DUPLICATE SYSTMA (2 FILES) 
POSITION SYSLBl AFTER SYSTMX 
POSITION SYSUT4 AT BEGINNING OF SYSTMA 
PUT SYSTMA ON NEW LIBRARY TAPE 
FINISH UP EDIT 



Figure 25. Sample Job Deck for Rearranging Subsystems on a 729 System Library Tape 



Creation of an Alternate Library 

An alternate library (i.e., a library not containing the 
System Monitor (ibsys) file and residing on syslb2, 3, 
or 4) can be created by using the extended *insert 
and *dup cards described below: 



1 
[TAPE] 



7 16 

♦INSERT [FILEMK] [,SYSALT] 



When the sysalt option is specified, the action 
called for by the *insert card takes place on the unit 
assigned to sysut3 rather than sysuti. 



7 
♦DUP 
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SYSxxx, SYSALT, n 
When the sysalt option is specified, the n files will 
be transferred from sysxxx to sysut3 and the results on 
sysut3 will be edited in the same manner as they 
would have been if sysuti had been used. 

Example: Assume that a system tape contains, 
among other things, a subsystem, systma, consisting 
of two files following ibsys. Further assume that a new 
subsystem, systmb, exists on sysut2 in column-binary 
card image form with one transfer card at the end. The 
sample job deck shown in Figure 26 could be used to 
create a new library on syslbi, without systma and 
systmb, and an alternate library ( to be used as syslb3 ) 
consisting of systma followed by systmb. 

Note: The Editor will finish the above edit by plac- 
ing the *eot record, which was written on sysuti, on 
sysut3 since the sysalt option was specified at least 
once during the edit. 



Maintenance of an Alternate Library 

An alternate library (one without ibsys) is modified 
by having it on syslb2 and using the syslb2 option on 
the *edit card. The edit will proceed in the normal 
fashion to sysuti. All Editor control cards except the 
♦place card and any cards on which sysalt is specified 
are available for modification of the alternate library. 
However, care must be taken not to change the alter- 
nate library so much that it is no longer correctly re- 
flected in the System Name Table of the syslbi ibsys 
file, since a new System Name Table cannot be gener- 
ated with this edit. If syslbi is on direct access storage, 
a new System Loader Table reflecting the edit (such 
as new track origins of the systems on the alternate 
library if sysuti is direct access storage) will auto- 
matically be rewritten in the ibsys file residing on syslbi. 
Note that the discussion above concerns editing, for 
maintenance purposes, of an alternate library. If the 
syslb2 option is used on the *edit card and the library 
on syslb2 contains the ibsys file, all Editor control cards 
are available. Editing proceeds from syslb2 to sysuti, 
and a new System Name Table, taken from the syslbi 
ibsys file and changed according to any *place cards, 
will be written as part of the ibsys file on sysuti. If 
sysuti is direct access storage, a System Loader Table 
is generated by the Editor and written on sysuti. In 
contrast to the alternate library edit, the System Loader 
Table of the ibsys file on syslbi, if it is direct access 
storage, is not changed. 
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$JOB 




$IBSYS 




$IBEDT 




• EDIT 


MAP, MODS 


•PLACE 


SYSTMA 


•PLACE 


SYSTMA, 2,3,1 


•PLACE 


SYSTMB, 1,3 


•AFTER 


FILEMK 


• DUP 


SYSLB1,SYSALT,2 


TAPE »INSERT 


SYSALT 


•INSERT 


FILEMK.SYSALT 


(END-OF-FILE CARD) 


$IBSYS 





DELETE SYSTMA REFERENCE IN SYSNAM 

MAKE NEW ENTRY WITH INDEX 3 

INSERT A SYSTMB REFERENCE 

EDIT TO SYSUTI UP TO SYSTMA 

PUT SYSTMA ON SYSUT3 

FOLLOW WITH SYSTMB ON SYSUT3 

PUT FILE MARK ON SYSUT3 

FINISH EDIT ON SYSUTI 



Figure 26. Sample Job Deck for Creating an Alternate Library 
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Introduction 

The complete 7090/7094 ibsys Operating System is 
preassembled for use with 729 Magnetic Tape Units 
and is distributed in binary form on a single 729 
System Library Tape. This tape can be used imme- 
diately without change by any installation employing 
729 Magnetic Tape Units, either for production job 
processing or for preparing a new System Library that 
meets the specific requirements of an installation. 

In addition to the preassembled 729-capability Sys- 
tem Library Tape, symbolic tapes containing the com- 
plete Operating System are also available. On these 
tapes, the System Monitor, the System Editor, the ibjob 
Processor, the Symbolic Update Program, the Utilities, 
and the Restart Program are written in the Macro As- 
sembly Program (map) language, and the remainder 
of the Operating System is written in the Fortran ii 
Assembly Program (fap) language. The symbolic tapes 
may be used, if necessary, to reassemble all or parts of 
the Operating System. The System Monitor and each of 
the subsystems on the symbolic tapes contain assembly 
parameters which may be replaced before assembly to 
change certain operating characteristics of the System 
and thereby tailor it to the needs of a particular in- 
stallation. 

If an installation is to employ 1301/2302 Disk Storage 
and/or 7340 Hypertape Drives, parts of the Operating 
System on one of the symbolic tapes must be updated 
(to replace assembly parameters ), assembled, and then 
edited onto a new System Library Tape, together with 
the remainder of the System. The preassembled 729- 
capability magnetic tape and an update-edit job deck 
that is distributed with the System may be used to 
perform these operations. 

The procedure for adding 7320 Drum Storage capa- 
bility to an installation is similar to the procedure for 
adding disk and/or Hypertape capability. The excep- 
tion is that the tape which is produced as a result of 
running the Disk/Drum/Hypertape Update-Edit Deck 
must be used in conjunction with the distributed sym- 
bolic tape which contains the ibjob Loader (ibldr) 
and the symbolic modification deck shown in Figure 58. 
This procedure modifies the loader portion of the ibjob 
processor for drum storage. (The 7320 Update-Edit 
Deck Number 2 is available upon request from the 
dp Program Information Department. ) This procedure 
produces a system tape on which the blocking factor 
for the ibjob Subroutine Library (iblib) has been 



changed to utilize full tracks of 7320 Drum Storage. 
These modifications should be made only if the ibjob 
Subroutine Library is to reside on drum storage. The 
System Library Tape produced by this run is then used 
in place of the tape obtained by means of the update- 
edit deck. 

This section of the publication contains informa- 
tion and procedures for performing the following: 

1. Preparing a backup System Library Tape. 

2. Changing System Unit assignments by patching. 

3. Preparing duplicate 729 System Library tapes for 
alternate use by the System Monitor. 

4. Adding 1301/2302 Disk Storage, 7320 Drum 
Storage, and/or 7340 Hypertape capability. 

5. Reassembling the System Monitor. 

6. Incorporating a user-designed installation ac- 
counting routine. 

7. Incorporating user programs as subsystems under 
System Monitor control. 

8. Incorporating ibm modifications to the 7090/7094 
ibsys Operating System. 

Additional information on changing the operating 
characteristics of the subsystems operating under Sys- 
tem Monitor control is contained in the manuals for 
the subsystems. 



Distributed Configuration of Input /Output Units 

The distributed 729-capability System Library Tape 
is assembled for the configuration of referable input/ 
output units shown in Figure 27. This configuration is 
designed to accommodate the actual configuration of 
729 Magnetic Tape Units existing at most installations. 
A unit control block is generated by the System Mon- 
itor for each of the referable units. However, an actual 
physical unit need not, and normally does not, exist 
at a particular installation for each unit control block 
generated when the distributed tape is used. 









Attached 


Detached 


Channel 


Unit Type 


Number 


Units 


Units 


Channel A 


711 Card Reader 


1 


RDA 






721 Card Punch 


1 


PUA 






716 Printer 


1 


PRA 






729 Magnetic Tape 


10 


A1...AB 


A9,A0 


Channel B 


729 Magnetic Tape 


10 


B1...B8 


B9,B0 


Channel C 


729 Magnetic Tape 


6 




C1...C6 


Channel D 


729 Magnetic Tape 


6 




D1...D6 



Figure 27. Configuration of Referable Input/Output Units on 
Distributed System Library Tape 
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System Unit 


Density 


Unit 


Assignments 


Assignment 


RDA 


SYSCRD 




PUA 


SYSPCH 




PRA 


SYSPRT 




A1 


SYSLB1 


high 


A2 


SYSIN1 and SYSIN2 


high 


A3 


SYSUT1 


high 


A4 


SYSUT3 


high 


A5 


SYSCK2 


high 


Bl 


SYSOU1 and SYSOU2 


high 


B2 


SYSPP1 


high 


B3 


SYSUT2 


high 


B4 


SYSUT4 and SYSPP2 


high 



Figure 28. System Unit Assignments on Distributed System 
Library Tape 



On the distributed preassembled System Library 
Tape, the card reader, the card punch, the printer, 
and nine of the 729 Magnetic Tape Units are as- 
signed to the system unit functions shown in Figure 
28. The remaining system unit functions have no units 
assigned. In general, the procedures described in this 
section are based on the assumption that the units 
listed in Figure 28 are physically connected. 

If the System Monitor is assembled from the dis- 
tributed symbolic tape without prior changes in as- 
sembly parameters, it will have the same configuration 
of referable units ( Figure 27 ) and system unit assign- 
ments (Figure 28) as the distributed preassembled 
System Library Tape. 



Preparing a Backup System Library Tape 

Although the following procedure is optional, it is 
strongly recommended, since it produces a System 
Library map for future reference and a duplicate Sys- 
tem Library Tape for emergency use. 

1. Place the sample job deck shown in Figure 29 
in the system input file on sysini (a2). 

2. Mount the distributed System Library Tape on 

SYSLBl (Al). 

3. Follow the initial start procedure described in 
the publication IBM 7090/7094 IBSYS Operating Sys- 
tem: Operators Guide, Form C28-6355. 

A duplicate of the distributed System Library Tape 
will be produced on sysuti (A3), and a map of the 
System Library will be produced on sysoui (bi). 



Changing System Unit Assignments by Patching 

The System Unit Function Table in the System Nu- 
cleus is generated at initial start from the 24-word 
Auxiliary System Unit Function Table in the ibsys rec- 
ord of the System Monitor. A symbolic listing of the 
distributed version of the auxiliary table is shown in 
Figure 38. The table is located in core storage, be- 
ginning at 15140 8 ( syslbi) and ending at 15167 8 
(sysut4). Note that in the distributed version of the 
table, the same unit ( B4) is assigned to both the syspp2 
and sysut4 functions. This unit is so assigned in the 
distributed version because syspp2 functions as a spill 
tape for the System Core-Storage Dump Program. 
Therefore, it must have a unit assigned to it. If sysppi 
and syspp2 are to be used alternately for reel switch- 
ing purposes, then a different unit must be assigned to 
either syspps or sysut4. The unit assigned to syspp2 
cannot be direct access storage. 

Temporary changes in the assignment of units to 
system unit functions can be made using the $attach 
and $as cards or the sswitch card. However, to perma- 
nently change the assignment of a unit to a system 
unit function, the entry for the function in the Aux- 
iliary System Unit Function Table must be changed. 
This may be done during an update and reassembly 
of the System Monitor, as described in the sections 
"Adding 1301 Disk Storage, 7320 Drum Storage, and/ 
or 7340 Hypertape Capability" and "Reassembling the 
System Monitor." Alternatively, entries in the table 
can be changed, without reassembly, by patching them 
(using octal alteration cards) during an edit run, as 
described in the following text. 

Changing the Assignment of 729 Magnetic Tape Units 
and Card Equipment 

Each entry for 729 Magnetic Tape Units and card 
equipment in the Auxiliary System Unit Function 
Table has the following format: 



pfx 



channel„unit 



$J0B 






BACKUP SYSTEM LIBRARY 


$IBSYS 








$DATE 






122564 


$I8E0T 








* 


EDIT 




MAP 


(END 


-0F- 


FIL 


E CARD) 


$ST0P 









Figure 29. Sample Job Deck for Preparing a Backup 729 Sys- 
tem Library Tape 



where pfx is the density assigned to the system unit 
function: mze for high density and pze for low density; 
and channel is a number from 1 through 8 ( correspond- 
ing to channels A through H) which indicates the 
channel of the unit assigned to the system unit func- 
tion. For the configuration of input/output units on 
the distributed tape, channel can range from 1 to 2. 
The value unit is the number of the 729 Magnetic Tape 
Unit (1 through 10), card reader (11), card punch 
(12), or printer ( 13) assigned to the system unit func- 
tion. As an example, if reel switching is desired for the 
system input, output, and peripheral punch functions, 
the sample job deck in Figure 30 might be used. 
Assuming that the System Library Tape on syslbi is 
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16 



$JOB 


CHANGE SYSTEM 


ASSIGNMENTS 


$IBSYS 






(IBEOT 






• EDIT 


MAP, MOOS 




•MODIFY 


IBSYS 




15150 »OCT 


40O005OOC0O2 


B5 AS SYSOU2 


15152 »OCT 


4C000600C001 


A6 AS SYSIN2 


15154 »OCT 


AC000600C002 


B6 AS SYSPP2 


(END-OF-FILE CARD) 




♦ STOP 







Figure 30. Sample Job Deck for Changing System Unit 
Assignments 



the distributed tape, this job deck will assign B5 as 
sysou2, A6 as sysin2, and B6 as syspp2; all at high density. 

Changing the Assignment of 7340 Hypertape Drives 

Each entry in the Auxiliary System Unit Function 
Table for 7340 Hypertape Drives has the following 

format: 

PZE channel„unit 

where channel is a number from 1 through 8 (cor- 
responding to channels A through H ) and unit is the 
full address of the Hypertape drive specified in the 
decrement portion of the first word of its unit control 
block, as shown in Figure 31. 

For example, to permanently assign hh9/i ( channel 
H, Hypertape drive 9, Data Channel Switch setting 2) 
as sysut2, the following octal alteration card would be 
used in a job deck similar to the one shown in Fig- 
ure 30: 



15160 



*OCT 



030051000010 



Changing the Assignment of 1301/2302 Disk Storage 
and 7320 Drum Storage 

An entry in the Auxiliary System Unit Function Table 
for direct access storage is similar to an entry for 
Hypertape except that bits 14 through 17 specify a 
module number (0-9 for disk; 0, 2, 4, 6, or 8 for drum), 
rather than a unit number, and bits 9 through 11 
are 001 for 1301 disk, 111 for 2302 disk, and 011 for 
drum, instead of 000. However, if direct access 
storage is assigned to a system unit function, a match- 
ing entry for the function must be made in the 24- 
word Auxiliary Disk/Drum Limits Table that 
immediately follows the Auxiliary System Unit Func- 



tion Table. A symbolic listing of the distributed 
version of this table is shown in Figure 39. In core 
storage, the Auxiliary Disk/Drum Limits Table begins 
at 15170 8 (syslbi) and ends at 15217 8 (sysuto). Note 
that in Figure 39 the locations corresponding to the 
syscrd ( 15174 8 ), sysprt ( 15175 8 ), and syspch ( 15176 8 ) 
functions are used for purposes unrelated to the Disk/ 
Drum Limits Table. Direct access storage would never 
be assigned to these functions. 

An entry in the Auxiliary Disk/Drum Limits Table 
has the following format; 

PZE dorg„dend 

where dorg and dend are the numbers of the first and 
last tracks, respectively, of the consecutive tracks in 
the direct access storage module ( which is specified in 
the corresponding entry in the Auxiliary System Unit 
Function Table) that are to be assigned to the system 
unit function. 

For example, to permanently assign tracks 0040 
through 0079 of 1301 disk storage module cdoi/o 
( channel C, Access 0, Module 1, Data Channel Switch 
setting 1) as sysut3, the following octal alteration cards 
would be used in a job deck similar to the one shown 
in Figure 30: 

15161 *OCT 023101000003 

15211 *OCT 000117000050 

To permanently assign tracks 0040 through 0079 of 
drum storage module CN02/0 (channel C, Access 0, 
Module 2, Data Channel Switch Setting 1 ) as sysut3, 
the first of the two octal alteration cards above would 
be changed to 

15161 *OCT 023302000003 

If the user wishes to maintain the Home Address 2 
identifiers ( HA2 s ) as they are defined in the HA2 Table 
(ha2tbl), no additional modifications are necessary. 
However, if the user wishes to change the HA2 defini- 
tion for one or more system unit functions, the cor- 
responding entry or entries in the ha2 Table must be 
modified. For example, to define the ha2 of sysut3 as 
pq rather than 00 (*oct 1212), the corresponding ha2 
Table entry must be modified as follows: 

xxxxx *OCT 004750000000 
where xxxxx is the octal location of the sysut3 entry in 
the ha2 Table. 



■8 9- 



■11 



12 



14 



17 



Reserve 
Flag 
(0) 



Channel 
Type 
(1 for 
7909) 



Channel 
(1-8) 



Device 

(000 for 
Hypertape) 
(001 for 1301 Disk) 
(011 for 1320 Drum) 
(111 for 2302 .Disk) 



Data 
Channel 
Switch 
(0 or 1) 



Access 
(Oor 1) 



Unit or Module 

Numbers 

(0-9 for Hyper- 
tape or Disk) 

(0, 2, 4, 6, or 
8 for Drum) 



Figure 31. Decrement of Entry for Hypertape, Disk, or Drum in Auxiliary System Unit Function Table 
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Preparing Duplicate 729 System Library Tapes 
for Alternate Use by the System Monitor 

To reduce delays in processing due to rewinding of 
the System Library Tape, the complete 7090/7094 
ibsys Operating System can be duplicated on two 729 
System Library Tapes that are used alternately by the 
System Monitor. A second, and alternate, method of 
reducing tape positioning time is described in the 
publication IBM 7090/7094 IBSYS Operating System: 
IBJOB Processor, Form C28-6389. With the alternate 
method, components of the ibjob Processor are placed 
on a second System Library Tape which, in conjunc- 
tion with a prepositioning feature in the ibjob Proc- 
essor, reduces delays in processing due to positioning 
of the System Library Tape. Heavy users of the ibjob 
Processor should consider using the method described 
in the ibjob Processor manual as an alternative to the 
method described in this manual. 

When duplicate System Library Tapes are used, one 
tape is placed on the 729 Magnetic Tape Unit assigned 
as syslbi and the other is placed on the unit assigned 
as syslb4. The entry in the Auxiliary System Unit Func- 
tion Table for syslb4 on both tapes must contain the 
following: 



MZE 



channel,!, unit 



where channel is the number of the channel ( 1 or 2 
on the distributed preassembled tape) and unit is the 
number of the 729 Magnetic Tape Unit ( 1 through 10 ) 
on that channel to be assigned as syslb4. The 1 in the 
tag portion of the auxiliary entry indicates to the Sys- 
tem Monitor that syslb4 does, in fact, contain a dupli- 
cate System Library Tape. The System Monitor will 
not alternate between duplicate System Library Tapes 
if the tag portion of the syslb4 entry is zero or if either 
syslbi or syslb4 or both are not 729 Magnetic Tape 
Units. 



»J0B 


DUPLICATE TAi 


SIBSYS 




$IBEDT 




• EDIT 




•MODIFY 


IBSYS 


15143 «0CT 


400UC510CCC1 


(END-OF-FILE CARD) 


SIBSYS 




SATTACH 


A3 


$AS 


SYSLB2 


SATTACH 


XK 


SAS 


SYSUT1 


$IBEDT 




•EDIT 


SYSLB2 


IEND-OF-FILE CARD) 


SSTOP 





NOTE, XK CAN BE ANY AVAILABLE 729 TAPE UNIT 



Figure 32. Sample Job Deck for Preparing Duplicate System 
Library Tapes for Alternate Use by the System 
Monitor 



The sample job deck in Figure 32 may be used to 
produce two duplicate System Library Tapes, in which 
the syslb4 auxiliary entry on both tapes is changed, as 
previously described, to allow alternate use of the 
tapes by the System Monitor. This deck will assign 
A5 as syslb4. It assumes that A3 is assigned initially as 
sysuti. The first of the two duplicate tapes will be 
produced on A3 (sysuti). A3 is then attached as 
syslb2 and is used to produce the second of the two 
duplicate tapes on a 729 Magnetic Tape Unit that 
is attached as sysuti. The 729 Magnetic Tape Unit 
specified on the second sattach card can be any avail- 
able unit. At the completion of the job, one of the two 
duplicate System Library Tapes will be on A3 and the 
other will be on the unit that is specified on the second 
$ attach card. 

If the System Monitor is reassembled, as described 
in the section "Reassembling the System Monitor," 
alternate use of duplicate System Library Tapes can 
be specified by the assembly parameter pp set cuu. 
This parameter is described in Figure 35, under the 
subheading "Miscellaneous Assembly Parameters," and 
is listed in Figure 36. 



Adding 1301/2302 Disk Storage, 7320 Drum 
Storage, and/or 7340 Hypertape Capability 

The distributed 729 capability System Library Tape, 
together with Symbolic Tape Number 1, may be used to 
produce a System Library with 1301/2302 Disk Storage, 
7320 Drum Storage, and/or 7340 Hypertape capability, 
in addition to 729 capability, for the System Monitor, 
the ibjob Processor, the Input/Output Control System, 
the Utilities, the Generalized Sorting System, and the 
Restart Program. The complete 7090/7094 Operating 
System can reside on direct access storage. Although 
each of the subsystems under ibsys has this capability, 
the complete system cannot physically reside on one 
7320 Drum Storage Unit. However, if a System Library 
is produced with Hypertape capability for the System 
Monitor, the ibjob Processor, the Input/Output Control 
System, the Utilities, the Generalized Sorting System, 
and the Restart Program, these portions of the Operat- 
ing System may reside on Hypertape, but the remain- 
der of the Operating System, if it is to be used, must 
reside on 729 magnetic tape. To produce a System 
Library with disk, drum, and/or Hypertape capability, 
portions of the 7090/7094 ibsys Operating System on 
the symbolic tape must be updated (to change as- 
sembly parameters), assembled, and then, together 
with the remainder of the 7090/7094 ibsys Operating 
System, edited onto a new System Library Tape. These 
functions may be performed using a Disk/Drum/ 
Hypertape Update-Edit Deck that is distributed with 
the 7090/7094 ibsys Operating System. This deck is 
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UPDATE INTERMEDIATE TAPE 
UPDATE OUTPUT TAPE 
UPDATE INPUT TAPE 



SJOB UPDATE EDIT DECK FOR 1301 DISK* 7320 DRUM AND 73*0 HYPERTAPE 

SIBSYS 

$UST 

SATTACM A* 

SAS SYSCK1 

SREWIND SYSUT4 

SREWIND SYSUT1 

SREWIND SYSCK1 

$* 

*♦ NEW SYMBOLIC TAPE NUMBER 1 WITH DISK* DRUM OR 

$* HYPERTAPE PARAMETERS WILL BE WRITTEN ON TAPE UNIT B4t 

$» 

UPDATE 

4*3 



SEXECUTE 

UPDATE 
SYSORG SET 



SSTOP 

ENDFIL 

ENDUP 

UPDATE 

CH7909 SET 

END 

ENDUP 

UPDATE 

CH7909 SET 

SSTOP 

ENDFIL 

REWIND 

ENDUP 

UPDATE 

END 

REWIND 

ENDUP 

UPDATE 

SET 

TTL 

BCI 

END 

REWIND 

ENDUP 

UPDATE 

SET 

TTL 

BCI 

END 

REWIND 

ENDUP 

UPDATE 

SET 

TTL 

BCI 



TRAIL 



TRAIL 



TRAIL 



SSTOP 



SSTOP 



HYPER 

DISK 

HYPER 

DISK 

DISK 



ENDFIL 
REWIND 
ENDUP 
UPDATE 

END 

ENDFIL 
ENDUP 
UPDATE 

ENDFIL 

ENDUP 

UPDATE 

SET 
SET 
SET 
SET 
SET 
END 
ENDFIL 



SECTION 1 PARAMETERS 



SECTION 2 PARAMETERS 



2000 



4.3 
1 



4.9 
1 



9*3 



9*3 

1 

PROCESS CONTROL UTILITIES-IBJOBY 

l.IBJOBY 



UTILITIES-IBJOBI 



9.3 

1 

PROCESS CONTROL 

l.IBJOBI 

9 



9.3 

1 

PROCESS CONTROL UTILITIES-1BJOBL 

l.IBJOBL 



4.3 



4.3 



4*3 

1 
1 
1 
1 
1 



SECTION 3 PARAMETERS 



SECTION 4 PARAMETERS 



♦ALL 



*ALL 

♦TRAIL 
*TRAIL 
♦TRAIL 

♦ALL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 
♦TRAIL 



IBB00250 
IBD17710 



1CJO1OO0 
11099990 



1PA01250 
1PC99999 



1PC99990 



1PA01374 
1PC12890 
1PC13790 
1PC99990 



1PA01374 
1PC12890 
1PC13790 
1PC99990 



1PA01374 
1PC12890 
1PC13790 
1PC99999 



♦TRAIL 



IOR15470 



ED099999 



♦HYPR 
♦DKDM 
♦HYPR 
♦DKDM 
♦DKDM 



3AK00210 
3AK00230 
3AL00270 
3AL00290 
3B000370 
3RN15370 



REWIND 
UNLOAD 
ENDUP 



SIBSYS 
$♦ 



$* 

$* 
t* 
S* 

s* 

$♦ 
$♦ 

SPAUSE 
SEXECUTE 

UPDATE 



PLEASE REMOVE THE DISTRIBUTED SYMBOLIC TAPE NO. 
A3 AND MOUNT A SCRATCH TAPE IN ITS PLACE. 



1 FROM TAPE UNIT 



A SYMBOLIC TAPE WITH ONLY THOSE RECORDS WHICH MUST BE REASSEMBLED 
FOR DISK, DRUM OR HYPERTAPE WILL NOW BE WRITTEN ON TAPE UNIT A3. 
PLEASE PRESS START WHEN ALL TAPE MOUNTING IS COMPLETE. 



UPDATE 
3.4 



IBD17690 



Figure 33. Distributed Disk/Drum/Hypertape Update-Edit Deck (Sheet 1 of 2) 
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END 


* 










ENDUP 








IBD17690 


UPDATE 


3.4 








SKIPTO 








1CJ00010 


END 








1CT99990 


SKIPTO 








1 I 000000 


END 








1PC99990 


ENDUP 










UPDATE 


3.4 




•TRAIL 




END 






•TRAIL 


1PC99990 


ENDUP 






'TRAIL 




UPDATE 


3.4 




•TRAIL 




END 






•TRAIL 


1PC99990 


ENDUP 






•TRAIL 




UPDATE 


3.4 




•TRAIL 




END 






•TRAIL 


1PC99990 


ENDUP 






•TRAIL 




UPDATE 


3.4 








SKIPTO 








IOAOOOOO 


SIBSYS 










SJOB 


7090-10-919 


. INPUT OUTPUT CONTROL SYSTEM. VERSION 


6 




SEXECUTE 


IBSFAP 








* FAP 










END 


-1 






IOF00510 


ENDUP 










UPDATE 


3.4 








SKIPTO 








3ACOOOO0 


SIBSYS 










SJOB 


IBJOB SUBROUTINE LIBRARY. 7090-LM-803. VERSION 5 






SEXECUTE 


IB JOB 








SIBJOB IBLIB 


MAP. LOGIC 








SEDIT 


LOGIC 








SREPLACE 


.JBC0N.ORG- 


03720 






SIEDIT 










END 








3AC00200 


SKIPTO 








3AE0OOOO 


SREPLACE 


.IODEF 








END 








3AE01990 


SKIPTO 








3AF00000 


SREPLACE 


.IOCSF 








END 








3AF28140 


SKIPTO 








3AKOOOO0 


SREPLACE 


.LOVRY 
.LOVRY 


IF THIS DECK IS TO BE RUN USING SYMBO 
TAPE NUMBER 1 CONTAINING VERSION 5 OF 






- 3AK03400 


END 
SKIPTO 






3AL00O0O 


SREPLACE 


• LXSL 


IBLIB AT A MODIFICATION LEVEL GREATER 








END 




THAN 3, THE SERIALIZATION MUST BE 






3AL02S20 


SKIPTO 


.IBDBI 


3AK10100. 






3B0O0O00 


SREPLACE 








END 


DSTRS 






3B020280 


SKIPTO 








31000000 


SREPLACE 


.IOCS 








END 








31056800 


ENDFIL 


4 








UNLOAD 


3 








ENDUP 










UPDATE 


.4.U 








SIBSYS 










SSWITCH 


SYSPPX.SYSU 


T2 






SIBEDT 










•EDIT 


MAP .MODS 








TAPE 'REPLACE 


IBSYS 








TAPE *REPLACE 


SYSDMP 








TAPE *REPLACE 


IBJOB 








TAPE 'REPLACE 


IOCSB 








TAPE 'REPLACE 


IBJOBB 








TAPE 'REPLACE 


IBJOBC 








'AFTER 


1BCBC9 




'TRAIL 




TAPE 'INSERT 


IBJOBY 




•TRAIL 




'AFTER 


IBFTCG 








TAPE 'INSERT 


IBJOB I 




'TRAIL 




'AFTER 


IBMAPK 




•TRAIL 




TAPE 'INSERT 


IBJOBL 




•TRAIL 




FILE 'REPLACE 


CIFSR.SYSUT 


4 






FILE 'REPLACE 


TIFSR.SYSUT 


4 






TAPE 'REPLACE 


IOCS 








TAPE 'REPLACE 


POST 








TAPE 'REPLACE 


PREP 








TAPE 'REPLACE 


IOBB 








TAPE 'REPLACE 


IOBM 








TAPE 'REPLACE 


NOBS 








ENDFIL 


4 








SIBSYS 













TAPE UNIT A3 NOW CONTAINS THE NEW SYSTAP 
WITH DISK. DRUM OR HYPERTAPE CAPABILITIES. 



REWIND 
ENDUP 



REWIND AND SWITCH TAPE UNITS A2 AND A3. 

DISMOUNT AND SAVE NEW SYMBOLIC TAPE ON B4 AND MOUNT A SCRATCH. 
REWIND SYSTAP. CLEAR AND LOAD TAPE TO ASSEMBLE AND EDIT A SYSTAP 
WITH DISK. DRUM OR HYPERTAPE CAPABILITY. 



SREWIND 
SPAUSE 



SYSPP1 



Figure 33. Distributed Disk/Drum/Hypertape Update-Edit Deck (Sheet 2 of 2) 
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listed in Figure 33. The portions of the 7090/7094 ibsys 
Operating System that are updated by the deck are 
contained on the 7090/7094 ibsys Operating System 
Symbolic Tape Number 1. The contents of this tape 
are as follows: 

File 1 System Monitor including the System Core- 
Storage Dump Program 
File 2 IBJOB Monitor 
File 3 Full IOCS ( Independent IOCS ) 
File 4 System Editor 
File 5 IBJOB Subroutine Library ( IBLIB ) 

Operations Performed by the Disk/Drum/Hypertape 
Update-Edit Job Deck 

Before using the Disk/Drum/Hypertape Update-Edit 
Deck, the user must prepare the deck (as described 
later in the text) to ensure a logical configuration of 
input/output units tailored to the physical limitations 
and operational requirements of his installation. The 
following sequence of operations is performed by the 
update-edit job deck: 

1. The portions of the 7090/7094 ibsys Operating 
System on Symbolic Tape Number 1 that contain disk, 
drum, and/or Hypertape assembly parameters are up- 
dated with the appropriate changes by the Symbolic 
Update Program. Other portions of Symbolic Tape 
Number 1 that do not contain these parameters are 
copied without change onto the update output tape. 
The ibjob trailer records ibjoby, ibjobi, and ibjobl are 
also copied onto the update output tape by means of 
special updating of the ibjob record on Symbolic Tape 
Number 1. 

This special form of Symbolic Tape Number 1 con- 
tains five files, updated where necessary for disk, drum, 
and/or Hypertape capability. These five files are: 

File 1 System Monitor including the System Core- 

Storage Dump Program 

File 2 IBJOB Monitor and the IBJOBY, IBJOBI, and 
IBJOBL records 

File 3 Full IOCS 

File 4 System Editor 

File 5 IBJOB Subroutine Library ( IBLIB ) 

2. A second and final update is performed which ex- 
tracts those portions of Symbolic Tape Number 1 which 
must actually be assembled for disk, drum, and/or 
Hypertape capability. Systems or portions of systems 
which are not needed for reassembly are deleted from 
this final symbolic tape, and the appropriate control 
cards are added to allow this tape to be used as a 
system input tape, which will assemble and edit the 
appropriate systems onto a new System Library Tape 
having disk, drum, and/or Hypertape capability. The 
updated Symbolic Tape Number 1 created during the 
job can now be removed and retained for use with 
any future ibm modifications to the subsystems and 
components contained on this tape. 



3. The selectively constructed system input tape on 
tape unit A3 is now interchanged manually with tape 
unit A2 ( the original system input tape ) . This tape now 
becomes sysin for the remainder of the job. 

4. The ibsys Monitor and the ibjob Monitor, together 
with the ibjob trailer records, if necessary, are assem- 
bled by the ibjob Processor. Independent iocs is as- 
sembled by the Fortran ii Assembly Program ( ibsfap ) . 
The ibjob Processor then assembles and edits the por- 
tions of the ibjob Subroutine Library containing the 
updated disk/drum/Hypertape assembly parameters. 

5. The System Editor produces a new System Li- 
brary Tape on tape unit as with the required disk, 
drum, and/or Hypertape capability by replacing the 
ibsys Monitor, the ibjob Monitor, the ibjob Subroutine 
Library, and Independent iocs from the distributed 
System Library Tape with their reassembled disk/ 
drum/Hypertape counterparts. 

The Assignment and Function of Units for the 
Disk/Drum/Hypertape Update-Edit Deck 

As distributed, the Disk/Drum/Hypertape Update- 
Edit Deck requires eight 729 Magnetic Tape Units. If 
a user has less than eight 729 Magnetic Tape Units, 
he should request his ibm representative to obtain a 
special procedure from the regional Programming Sys- 
tems Support Group. 

The Disk/Drum/Hypertape Update-Edit Deck is de- 
signed for use with the distributed System Library 
Tape with the input/output units initially assigned to 
system unit functions, as shown in Figure 28. The 
assignment and function of the units for the Disk/ 
Drum/Hypertape Update-Edit Deck are as shown in 
Figure 34. 
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Figure 34. The Assignment and Function of Units for the Disk/ 
Drum/Hypertape Update-Edit Deck 

The distributed System Library Tape is mounted on 
Al, the Symbolic Tape Number 1 is mounted on A3, and 
the system input tape (containing the update-edit 
deck) is mounted on A2. 

The tape written on B4 and the final tape written on 
A3 should be saved. These two tapes contain the follow- 
ing: 
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Tape on B4: Updated Symbolic Tape Number 1 con- 
taining the System Monitor, the ibjob Monitor, and 
possibly the ibjoby, ibjobi, and ibjobl trailer records 
( see the section "Removal and Replacement of Cards 
in the Distributed Deck"), Full iocs (.Independent 
iocs), the System Editor, and the ibjob Subroutine Li- 
brary (iblib). 

Tape on A3: New System Library Tape in binary 
form, containing the complete 7090/7094 ibsys Operat- 
ing System with disk, drum, and/or Hypertape capa- 
bility for the System Monitor, the ibjob Processor, the 
Input/Output Control System, the Utilities, and the 
Restart Program. 

Preparing the Disk/Drum/Hypertape Update-Edit Deck 

Before using the distributed update-edit deck, certain 
control cards and assembly parameter cards already 
in the deck may have to be removed or replaced, and 
assembly parameter cards and cards for changing sys- 
tem unit assignment must be inserted in the deck. The 
insertion of these cards establishes the logical config- 
uration of disk, drum, and/or Hypertape units re- 
quired for a specific installation. Although the distrib- 
uted job deck is designed primarily for changing the 
operating characteristics of the system to achieve 
direct access storage and/or Hypertape capability, Sys- 
tem Monitor assembly parameters can, if necessary, be 
inserted in the deck in order to change (during the 
same job run) operating characteristics of the system 
that are not directly related to disk, drum, or Hyper- 
tape. 

Assembly parameters that may be inserted in the 
update-edit job deck, together with the entries in the 
Auxiliary System Unit Function Table and the Auxiliary 
Disk/Drum Limits Table, are listed in Figures 36 
through 43 as they appear in the distributed ibsys Sym- 
bolic Tape Number 1. They are listed in the relative 
order in which they would be placed in the job deck. 
Assembly parameters that are related to disk, drum, 
or Hypertape capability contain *disk, *drum, or 
*hypr, respectively, in columns 67 through 71. Param- 
eters that are related to both disk and drum contain 
*dkdm in columns 67 through 71. Assembly parameters 
that are not directly related to either disk, drum, or 
Hypertape capability contain blanks in columns 67 
through 71. The use of these parameters is optional. 
Other assembly parameters, which merely indicate 
whether or not disk, drum, and/or Hypertape capa- 
bility are desired, are already included in the dis- 
tributed update-edit deck. Most of these parameters are 
required for disk, drum, and Hypertape capability and 
therefore contain *all in columns 67 through 70. 

Assembly parameter cards listed in Figures 36 
through 43 are grouped into four sections for insertion 
in the update-edit deck. These sections are numbered 



from 1 through 4 and the section to which each type 
of assembly parameter card belongs is indicated in 
the title of the figure in which it is shown. The places 
at which assembly parameters of each section are to 
be inserted in the update-edit deck are indicated by 
four cards containing the following message: 

SECTION x PARAMETERS 

where x is either 1, 2, 3, or 4. As assembly parameter 
cards are inserted in the deck, these four cards should 
be removed. However, before inserting assembly 
parameter cards, certain cards already in the deck may 
be removed or replaced, depending on the require- 
ments of an installation. The following procedure 
should be followed to prepare the distributed update- 
edit deck for use. 

Removal and Replacement of Cards in the Distributed Deck 
The ibsys Symbolic Tape Number 1 is distributed in 
either of three densities: 800 cpi, 556 cpi, or 200 cpi. 
The user must verify that the Disk/Drum/Hypertape 
Update-Edit Deck will read sysuti (the distributed 
Symbolic Tape Number 1) in the correct density. In 
the distributed deck, high density is assumed for all 
units. If the user requires the System Library Tape, 
created as a result of running the update-edit job deck, 
to be at 800 cpi, Symbolic Tape Number 1 should be 
ordered at 800 cpi. If, for some reason, the user finds 
working with 800 cpi tapes undesirable, Symbolic Tape 
Number 1 may be ordered at 556 cpi, and the update- 
edit deck may be run with the computer in Mode B 
(556/200 cpi). The result of operating in this manner 
will be the creation of a new System Library Tape 
written at 556 cpi. 

If the System Library Tape generated by the update- 
edit deck is to reside on direct access storage exclu- 
sively, the direct access storage requirements may be 
reduced by removing the cards in the distributed deck 
which cause the ibjoby, ibjobi, and ibjobl trailer rec- 
ords of the ibjob Monitor to be assembled and edited 
onto the new System Library Tape. To accomplish 
this, remove all cards containing *trail in card col- 
umns 66-71. If this change is made in the distributed 
deck, the updated Symbolic Tape Number 1 will not 
contain the ibjoby, ibjobi, and ibjobl records. If the 
System Library produced by the update-edit deck is 
ever to reside on a 729 Magnetic Tape Unit or 7340 
Hypertape Drive, the changes described above should 
not be made. 

Immediately following the insertion point in the 
update-edit deck for the section 4 parameters are five 
parameter cards. If only direct access storage capa- 
bilities are to be added, the two cards containing *hyfr 
in columns 67 through 71 should be removed from the 
deck. If only 7340 capability is to be added, the three 



56 



5 1 






3 



Symbol Code 



Varioble 



Description 
Miscellaneous Assembly Parameters 



IBSORG 
IOXORG 

SYSORG 

SYSEND 
HIGHLO 

PP 



EJECT 


SET 


DBLSP 


SET 


RDUNRT 


SET 


ETMODE 


SET 



CHA1 
CHAAT 



CHAMD 

PRNTA 
PNCHA 
CDRDA 



SET 
SET 



The decimal number x specifies the machine type; 709 for IBM 709 and 7090 for IBM 
7090/7094. If IBM SET 709, the instructions that refer to the "Set Density" opera- 
tions in (NDATA are deleted). 

The decimal number x is the origin of the System Nucleus. It cannot be less than 64. 

The decimal number x is the origin of IOEX. It cannot be less than the location of the 
last word of the last unit control block plus one. 

The decimal number x is the common subsystem origin. It cannot be less than the last 
location used by IOEX plus 51 . For disk, drum and /or Hypertape capability SYSORG 
should be at least 2000. 

The decimal number x is the common upper core limits for all subsystems. SYSEND+1 
should be the origin of an installation accounting routine if it exists. 

The decimal number x specifies the density to be assigned to a unit if the density speci- 
fication is omitted from an JAS card. If x is 1 , high density is assigned. If x is 0, low 
density is assigned. 

This parameter may be used to specify alternate use of duplicate 729 System Library tapes 
on SYSLB1 and SYSLB4. The decimal digit c is the channel number (1 through 8) and uu 
is the number of the 729 tape unit (1 through 10) on that channel to be assigned as 
SYSLB4. If PP SET is specified, the System Monitor will not alternate between 
duplicate System Library Tapes. 

The decimal number x specifies the printer board sense exit (1 through 10) for an eject. 

The decimal number x specifies the printer board sense exit (1 through 10) for a double 
space. 

The decimal number x is the number of recovery attempts IOEX should make on a read 
redundancy before the redundancy is considered permanent. 

If the decimal number x is I, trap mode will be saved by IOEX. If x is 0, trap mode 
will remain in effect in IOEX. 



Input/Output Configuration Assembly Parameters 



SET 
BOOL 



BOOL 



The decimal number x is the number of 729 Magnetic Tape Units existing on channel A. 

The rightmost 13 bits of xxxxx correspond to the card reader, card punch, printer, and 
729 Magnetic Tape Units 1 through 10, respectively, beginning with the leftmost of 
the 13 bits. If a bit is a zero, the corresponding unit is attached to the channel; a 
one-bit specifies a detached unit. 

The rightmost 10 bits of xxxx correspond to 729 Magnetic Tape Units 1 through 10, re- 
spectively, beginning with the leftmost of the 10 bits. If a bit is zero, the model type 
of the corresponding 729 Magnetic Tape Unit is specified as II or V; a one-bit specifies 
a IV or VI model type. 

If the decimal number x is a 1 , the printer is considered to exist on channel A. If no 
printer exists on channel A, x should be 0. 

If a card punch exists on channel A, the decimal number should be 1; otherwise x 
should be 0. 

If a card reader exists on channel A, the decimal number should be 1; otherwise x 

should be 0. 

NOTE: A unit control block is generated at initial start for every unit that exists 
on channel A as specified by CHA1 for 729 Magnetic Tape Units, PRNTA 
for the printer, PNCHA for the card punch, and CDRDA for the card reader. 
The parameter CHAAT merely specifies that the unit control block that is 
generated should indicate that the unit is either attached or detached. 

The decimal number x specifies the number of 7340 Hypertape Drives (0 through 10) that 
exist on Data Channel Switch setting 1 for channel A. 



Symbol Code 



Description 



HTA2 

HTAA2 

DFA1 

DFA3 
NFA1 
DFAA1 



IFA1 


SET 


DFA2 


SET 


DFA4 


SET 


NFA2 


SET 


DFAA2 


BOOL 


IFA2 


SET 



SET 

BOOL 

SET 

SET 
SET 
BOOL 



Input/Output Configuration Assembly Parameters 



The rightmost 10 bits of xxxx specify which of the Hypertape drives (specified in HTA1) 
on Data Channel Switch setting 1 are attached, beginning with the leftmost of the ten 
bits. If a bit is a zero, the corresponding drive is attached to the channel; a one-bit 
specifies a detached unit. For example, if there are eight Hypertape drives on channel 
A, Data Channel Switch setting 1 , and only six of the eight are to be attached, the 
following should be specified: 

HTA1 SET 8 

HTAA1 BOOL 0017 

Although the two units in this example, AH6/0 and AH7/0, will not be attached at 
initial start, they ma/be temporarily attached by means of a $ATTACH control card. 
Units AH8/0 and AH9/0, however, cannot be attached with a SATTACH card since 
HTA1 SET 8 and, therefore, no unit control block will be generated for them at initial 
start. 

HTA2 is the same as HTA1 except that it applies to Hypertape drives on Data Channel 
Switch setting 2 . 

HTAA2 is the same as HTAA1 except that it applies to Hypertape drives (specified in 
HTA2) on Data Channel Switch setting 2. 

The decimal number x specifies the number of 1301 Disk Storage modules (0 through 10) 
that exist on Data Channel Switch setting 1 for channel A. 

The decimal number x specifies the number of 2302 Disk Storage modules (0 through 10) 
that exist on Data Channel Switch setting 1 for channel A. 

The decimal number x specifies the number of 7320 Drum Storage modules (0 through 5) 
that exist on Data Channel Switch setting 1 for channel A. 

The rightmost 10 bits of xxxx specify which of the disk or drum modules (specified in 
DFA1 and NFA1) on Data Channel Switch Setting 1 are attached, beginning with the 
leftmost of the 10 bits. If a bit is zero, the corresponding module is attached; a one- 
bit specifies a detached module. 

The decimal number x specifies the 7631 model type for disk and drum modules on Data 
Channel Switch setting 1. If the model type is III or IV, x is 1; otherwise x is 0. 

DFA2 is the same as DFA1 except that is applies to disk modules on Data Channel 
Switch setting 2. 

DFA4 is the same as DFA3 except that it applies to disk modules (specified in DFA2) 
on Data Channel Switch setting 2. 

NFA2 is the same as NFA1 except that it applies to drum modules on Data Channel 
Switch setting 2. 

DFAA2 is the same as DFAA1 except that it applies to disk and drum modules (specified 
"n DFA2 and NFA2) on Data Channel Switch setting 2. 

IFA2 is the same as IFA1 except that it applies to disk and drum modules on Data Channel 
Switch setting 2. 



ONLIN BOOL 



DBLSPC 
KEYSWT 



System Core-Storage Dump Program Assembly Parameters 



BOOL 
SET 



This parameter determines whether dump output will be listed on the System Output Unit 
only or whether the tag portion of the control word (Figure 5) or console entry keys will 
determine the output unit. If x is 0, the tag will determine the output unit. 

If x is 0, dump output will be single-spaced. If x is 1 , output will be double spaced. 

The decimal number x determines the sense switch (1-6) that will be tested for the con- 
sole entry keys option. 

The decimal number x determines the output format (1-6) hSat will be used by the dump 
program when none is specified. Output formats and their numbers are shown in Figure 6. 



Figure 35. Explanation of System Monitor Assembly Parameters 
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Figure 36. Miscellaneous System Monitor Assembly Parameters ( section i 



cards containing *dkdm in columns 67 through 71 
should be removed. If disk, drum, and Hypertape capa- 
bilities are all to be added, none of the five cards 
should be removed from the deck. 

Inserting Miscellaneous System Monitor Assembly Parameters 

If any changes are to be made to the distributed ver- 
sion of the miscellaneous System Monitor assembly 
parameters in Figure 36, the appropriate cards should 
be punched and inserted as part of the section i 
parameter cards in the update-edit deck. These param- 
eters are described in Figure 35. For disk, drum, and/or 
Hypertape capability, the sysorg parameter must be at 
least 2000io. Therefore, a card with sysorg equal to 
2000io is included in the distributed update-edit deck. 
If other miscellaneous System Monitor assembly 
parameter cards are to be inserted in the deck, they 
should precede or follow the sysorg parameter card, 
depending on their serialization. 

Inserting Input/Output Configuration Assembly Parameters 

The input/output configuration assembly parameters 
(shown in Figure 37) that are to be changed are in- 
serted as part of the section 1 parameter cards in the 
update-edit deck, immediately following the miscel- 
laneous System Monitor assembly parameters. These 
parameters are described in detail in Figure 35. Since 
the parameters for each channel are similar, only the 
parameters for channel A are described in Figure 36. 
The parameters that are changed should be inserted 
in the deck in the same relative order as they are listed 
in Figure 37. 

Inserting Changes to Entries in the Auxiliary System Unit 
Function and Disk/Drum Limits Tables 

Changes to entries in the Auxiliary System Unit Func- 
tion Table (Figure 38) are inserted as part of the 
section 1 parameter cards in the update-edit deck, 
immediately following the input/output configuration 
assembly parameters. These changes are followed by 
any changes to the Auxiliary Disk/Drum Limits Table 
(Figure 39). 

Changing the Assignment of 729 Magnetic Tape 
Units and Card Equipment: Each entry for 729 Mag- 



netic Tape Units and card equipment in the Auxiliary 
System Unit Function Table has the following format: 



pfx 



channel„unit 



where pfx is the density assigned to the system unit 
function: mze for high density and pze for low density; 
and channel is a number from 1 through 8 ( correspond- 
ing to channels A through H) which indicates the 
channel of the unit assigned to the system unit function. 
The value unit is the number of the 729 Magnetic Tape 
Unit (1 through 10), card reader (11), card punch 
( 12), or printer ( 13) assigned to the system unit func- 
tion. As an example, the following card would be 
inserted in the update-edit deck to assign 729 Magnetic 
Tape Unit B5 as sysou2 at low density: 



SYSOU2 



PZE 



2„5 



IBB42360 



Changing the Assignment of 7340 Hypertape Drives: 
Each entry in the Auxiliary System Unit Function 
Table has the following format: 



PZE 



channel„unit 



where channel is a number from 1 through 8, corre- 
sponding to channels A through H, and unit is the 
full address of tlje Hypertape drive specified in the 
decrement portion of the first word of its unit control 
block, as shown in Figure 31. The decimal equivalent 
of a Hypertape drive address may be specified in the 
decrement portion of an entry, or a bool pseudo- 
operation may be used to define the address. For 
example, to assign hhq/i ( channel H, Hypertape drive 
9, Data Channel Switch setting 2) as sysut2, the fol- 
lowing cards would be inserted among the section 1 
parameter cards in the update-edit deck: 



H 
SYSUT2 



BOOL 
PZE 



30051 
8„H 



IBB42439 
IBB42440 



Changing the Assignment of 1301/2302 Disk Storage 
and 7320 Drum Storage: An entry in the Auxiliary Sys- 
tem Unit Function Table for disk or drum storage is 
similar to an entry for Hypertape except that bits 14 
through 17 specify a module number (0-9 for disk; 0, 
2, 4, 6, or 8 for drum), rather than a unit number, 
and bits 9 through 11 are 001 for 1301 disk, 111 for 
2302 disk, and 011 for drum, instead of 000 (see Figure 
31). For example, to assign 1301 disk storage module 
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Figure 37. Input/Output Configuration System Monitor Assembly Parameters ( section i 
(Sheet 1 of 2) 
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Figure 37. Input/Output Configuration System Monitor Assembly Parameters ( section i ) 
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Figure 38. Auxiliary System Unit Function Table ( section i ) 
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Figure 39. Auxiliary Disk/Drum Limits Table ( section i ) 



ONLIN 


BOOL 


1 


DBLSPC 


BOOL 





KEYSWT 


SET 


4 


FORMAT 


SET 


3 



IBDO0210 
IBD00220 
IBD00230 
IBD00240 



Figure 40. System Core-Storage Dump Assembly Parameters ( section i ' 



NOCH SET 
NOHYP SET 



NO. OF DIRECT ACCESS MODULES DEFINED IN IOCS *DKDM 11000310 
NO. OF HYPERTAPE CHANNELS DEFINED IN IOCS *HYPR 11000330 



Figure 41. ibjob Monitor Assembly Parameters for Disk, Drum, and Hypertape (section 2 ' 



NOCH EQU 
NOHYP EQU 



NO. OF DIRECT ACCESS MODULES DEFINED IN IOCS »DKDM I0A00360 
NO. OF HYPERTAPE CHANNELS DEFINED IN IOCS «HYPR IOA00380 



Figure 42. Full iocs ( Independent iocs ) Assembly Parameters for Disk, Drum, and Hypertape 

( SECTION 3 ) 
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NO. OF DIRECT ACCESS MODULES DEFINED IN IOCS »DKDM 3AE00060 
NO. OF HYPERTAPE CHANNELS DEFINED IN IOCS *HYPR 3AE00080 

NO. OF DIRECT ACCESS MODULES DEFINED IN IOCS *DKDM 3AF00270 
NO. OF HYPERTAPE CHANNELS DEFINED IN IOCS *HYPR 3AF00290 

NO. OF DIRECT ACCESS MODULES DEFINED IN IOCS »DKDM 31000300 
NO. OF HYPERTAPE CHANNELS DEFINED IN IOCS *HYPR 3IO0O320 



Figure 43. ibjob Subroutine Library Assembly Parameters for Disk, Drum, and Hypertape 

( SECTION 4 ) 
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0, Module 1, Data Channel Switch setting 1 ) as sysut3, 
the following cards would be inserted among the sec- 
tion i parameter cards in the update-edit deck: 



D 
SYSUT3 



BOOL 
PZE 



23101 
3„D 



IBB42449 
IBB42450 



When a direct access storage module is assigned to 
a system unit function, a matching entry must be made 
in the Auxiliary Disk/Drum Limits Table ( Figure 39 ) 
which defines the limits of the disk or drum storage area 
that is to be assigned to the function. An entry in the 
Auxiliary Disk/Drum Limits Table has the following 
format: 



PZE 



dorg„dend 



where dorg and dend are the numbers of the first and 
last tracks, respectively, of the consecutive tracks in 
the disk or drum storage module (which is specified 
in the corresponding entry in the Auxiliary System 
Unit Function Table) that are to be assigned to the 
system unit function. For example, if tracks 0040 
through 0079 of the disk storage module in the pre- 
vious example are assigned as sysut3, the following 
card would be inserted in the Disk/Drum/Hypertape 
Update-Edit Deck: 



PZE 



40„79 



IBB42680 



Inserting System Core-Storage Dump Assembly Parameters 

If any changes are to be made in the distributed 
version of the assembly parameters for the System 
Core-Storage Dump Program (shown in Figure 40), 
the appropriate cards should be punched and inserted 
as part of the section i parameter cards in the Disk/ 
Drum/Hypertape Update-Edit Deck, immediately fol- 
lowing the cards for changing entries in the Auxiliary 
System Unit Function and Disk/Drum Limits Tables. 
The core-storage dump parameters are described in 
Figure 35. 

Inserting IBJOB Monitor Assembly Parameters for Disk, Drum, 
and Hypertape Capability 

The irjoh Monitor assembly parameters for disk, drum, 
and Hypertape capability are listed in Figure 41. If 
only 1301 and 7320 capability is to be added, the card 
containing *dkdm in columns 67 through 71 should be 
punched and inserted as the section 2 parameter cards 
in the Disk/Drum/Hypertape Update-Edit Deck. The 
variable field of the card should contain a decimal 
number which indicates the number of 1301 and 7320 
modules that may be used by the Component iocs in 
the ibjob Monitor. If only 7340 capability is to be added, 
the card containing *hypr in columns 67 through 71 
should be punched to indicate the number of 7340 
Hypertape channels to be used by Component iocs 
and inserted as the section 2 parameter cards in the 



Disk/Drum/Hypertape Update-Edit Deck. If 1301, 
7320, and 7340 capability are all to be added, both 
cards should be prepared and inserted in section 2 
of the update-edit deck. 

Inserting Full IOCS (Independent IOCS) Assembly Parameters 
for Disk, Drum, and Hypertape Capability 

The Full iocs ( Independent iocs) assembly parameters 
for direct access storage and Hypertape capability are 
listed in Figure 42. These parameters are inserted as 
the section 3 parameter cards in the Disk/Drum/ 
Hypertape Update-Edit Deck and indicate the number 
of 1301 Disk Storage modules, 7320 Drum Storage 
modules, and/or 7340 Hypertape channels that may 
be used by the Full iocs (Independent iocs). Other- 
wise, the procedure for preparing and inserting these 
parameters is the same as for the ibjob Monitor as- 
sembly parameters. 

Inserting IBJOB Subroutine Library Assembly Parameters for 
Disk, Drum, and Hypertape Capability 

The ibjob Subroutine Library assembly parameters for 
direct access storage and Hypertape capability, shown 
in Figure 43, indicate the number of 1301 modules, 
7320 modules, and/or 7340 Hypertape channels that 
may be used by the Library iocs in the ibjob Processor. 
The first four of these parameter cards are inserted as 
the section 4 parameter cards in the Disk/Drum/ 
Hypertape Update-Edit Deck. The last two parameter 
cards are inserted, as indicated by their serial numbers, 
after the fifth card following the section 4 parameter 
insertion point of the update-edit deck. Otherwise, the 
procedure for preparing and inserting these parameters 
is the same as for the ibjob Monitor. 

Operating Procedure for the Disk/Drum/Hypertape 
Update-Edit Deck 

After the Disk/Drum/Hypertape Update-Edit Deck 
has been prepared, as described in the preceding sec- 
tion, the following procedure should be followed to 
generate a new System Library Tape with disk, drum, 
and/or Hypertape capability. 

1. Place the prepared update-edit deck in the Sys- 
tem Input File on sysini ( A2 ) . 

2. If disk and/or Hypertape capability is being 
added, mount the distributed 729-capability System 
Library Tape on syslbi (ai). If drum capability is being 
added, either alone or along with disk and/or Hyper- 
tape capability, mount the System Library Tape which 
was obtained by running the symbolic tape with the 
symbolic modification deck (see the third paragraph 
under the "Introduction" to this section) on syslbi. 

3. Mount the distributed ibsys Symbolic Tape 
Number 1 on A3. 
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4. Mount work tapes on bi, b2, B3, b4, and A4. 

5. Follow the initial start procedure described in the 
publication IBM 7090/7094 IBSYS Operating System: 
Operators Guide, Form C28-6355. 

6. Follow the operating instructions printed on the 
System Printer. 

The output tapes produced during the job run are de- 
scribed in the section "The Assignment and Function 
of Units for the Disk/Drum/Hypertape Update-Edit 
Deck." Refer to the "System Editor" section of the man- 
ual for information on editing the new System Library 
onto direct access storage or Hypertape. 



Reassembling the System Monitor 

Although reassembly of the System Monitor is nor- 
mally not required unless direct access storage and/or 
Hypertape capability is to be added, it may be neces- 
sary at some installations to add an installation account- 
ing routine or otherwise tailor the System Library to 
special installation requirements. The sample job deck 
in Figure 44 may be used for this purpose. Before the 
deck is used, any symbolic cards for inserting or chang- 
ing coding, changing assembly parameters, and/or 
changing system unit assignments must be inserted in 



the deck immediately following the update pseudo- 
operation card. The assembly parameter and system 
unit assignment cards should be inserted in the order 
in which they appear in Figures 36 through 40. The 
System Monitor assembly parameters are described in 
Figure 35. The formats of the entries in the Auxiliary 
System Unit Function Table and Auxiliary Disk/Drum 
Limits Table are described in the preceding text, in the 
section "Inserting Changes to Entries in the Auxiliary 
System Unit Function and Disk/Drum Limits Tables." 
For the sample job deck, the symbolic tape con- 
taining the System Monitor is mounted on A4 and the 
distributed System Library Tape is mounted on ai. 
The deck produces an updated symbolic tape contain- 
ing the System Monitor on B3 and the new System 
Library Tape on A3. 



Incorporating a User-Designed Installation 
Accounting Routine 

A user may, if he wishes, design an installation ac- 
counting routine tailored to his requirements and in- 
corporate it into the System Library as part of the 
7090/7094 ibsys Operating System. The accounting 
routine may be designed to perform a variety of 
functions, such as job timing, job billing, or produc- 
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Figure 44. Sample Job Deck for Updating and Assembling the System Monitor 
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ing statistical data on the processing of jobs. Since 
accounting practices vary considerably from installa- 
tion to installation, a specific accounting routine is 
not provided with the 7090/7094 ibsys Operating Sys- 
tem. However, facilities are provided for incorporating 
into the system an installation accounting routine 
specifically designed by the user to meet his own re- 
quirements. 

There are three one-word entries in the Communi- 
cations Region of the System Nucleus that are used 
specifically for accounting purposes: sysidr, sysacc, 
and syspid. The function of each of these entries is 
described in detail in the following text. 

An installation accounting routine may either be 
incorporated as part of the System Monitor and be 
available for use by the System Monitor and each of 
the subsystems, or it may be incorporated as part of 
a subsystem where it is available for use by the sub- 
system only. Both methods of incorporating an ac- 
counting routine are described below. 

Designing an Installation Accounting Routine 

There are several considerations about the relationship 
of an installation accounting routine to the ibsys oper- 
ating system which should be kept in mind when de- 
signing an accounting routine. These considerations 
are discussed below. 

Location and Size 

An accounting routine must be loaded into upper core 
storage and must not occupy more than 500 words. 
There are two subsystems that will not respect the 
upper 500 words of core storage and may overlay all 
or part of an accounting routine. 

1. Fortran ii respects only the upper 64 words of 
core storage. 

2. In ibjob, if $dump or spatch cards are used, the 
jdump routine is loaded into upper core storage over- 
laying the accounting routine, and the contents of 
sysidr are replaced by tra 2,4. 

Calling Sequence 

Access to an accounting routine is through location 
sysidr in the Communication Region of the System 
Nucleus, sysidr must be patched to contain a transfer 
to the accounting routine ( see the section "Incorporat- 
ing an Accounting Routine into the System Monitor"). 
Whenever the System Monitor or any of its subsystems 
processes a $job or a $id card, a transfer is made to the 
accounting routine through sysidr (i.e., tsx sysidr,4). 
In addition, some processors under control of ibjob, 
Commercial Translator, and 9pac make a sign-on 
transfer to the accounting routine before they begin 
processing. There may be more than one sign-on for 
a job under ibjob or Commercial Translator. For ex- 



ample, ibmap will sign-on before starting assembly of 
a source program in the map language, and the Loader 
will sign-on before loading the object program as- 
sembled by ibmap. When all processing is complete for 
a job under ibjob or Commercial Translator, there will 
be one ( and only one ) sign-off transfer to the account- 
ing routine. 

The calling sequence used in transferring to the 
accounting routine is: 



TSX 
pfx 



SYSIDR.4 

loc,t,n 

return 



where: 



pfx = PZE for $JOB/$ID calls 

PON for sign-on calls 

PTW for sign-off calls 

PTH for intraprocessor calls 

(prefix codes FOR, FIVE, SIX, and SVN may be used 

for special purposes by an installation ) 
loc = location of first word of an identifying message or a 

control card buffer (not always present) 
t = identifier of sign-on and sign-off calls 

1 = compiler 

2 = assembler 

3 = loader 

4 = execution 

5 = utility 

(6 and 7 may be used for special purposes by an in- 
stallation ) 

n = number of words occupied by identifying message or 
control card buffer (not always present) 

In some cases the sign of the ac is tested upon return 
from the accounting routine. If the sign is found to be 
plus ( + ), processing continues. If the sign is found 
to be minus ( — ), processing is terminated and control 
is returned to the supervising monitor. Figure 45 gives 
the contents of the parameter words for the calls by 
various processors and indicates whether the sign of 
the ac is tested on return ( the sign of the ac is never 
tested on return from a sign-off call). 

$JOB and $ID Cards 

The contents of the $job or $id card are stored in a 
buffer prior to being printed on-line. The location and 
length of this buffer is stored in the parameter word 
(pze) of the calling sequence (see the section "Calling 
Sequence") so that the accounting routine may have 
access to the data in columns 16-72 of the $job card 
or columns 7-72 of the $id card. The data on these cards 
may be set up in any form desired for use by the 
accounting routine. 

SYSACC 

The System Monitor or the subsystem processing a 
$job or $id card tests location sysacc. If the contents of 
sysacc are zero, the card is printed on-line. If sysacc 
contains anything other than zero, the card is not 
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$JOB/$ID 



Sign-On 



Sign -Off 





Parameter 


Sign of 


Parameter 


Sign of 


Parameter 


Processor 


Word* 


AC Checked 


Word 


AC Checked 


Word 


IBSYS Monitor 


PZE loc,,n 


No 








Symbolic Update 


PZE loc,,n 


Yes 








Sort 


PZE loc,,n 


No 








IOCS 


PZE loc,,n 


No 








Utilities 


PZE loc,,n 


No 








IBJOB 


PZE loc,,n 


Yes 






PTW 0,0,0 


IBFTC 






PON 0, 1, 


** 




IBCBC 






PON 0, 1, 


No 




IBMAP 






PON loc,2,n 


Yes 




Loader 


PZE loc,,n 


Yes 


PON loc,3,n 


Yes 


PTW loc,3,n 


Execution 










PTW 0,4,0 


CT Monitor 


PZE loc,,n 


No 








Compiler 






PON 0,1,0 




PTW 0,1,0 


Loader 






PON 0,3,0 


Yes 


PTW 0,3,0 


Postprocessor 






PON loc,5,n 


Yes 


PTW loc,5,n 


KPOUT*** 










PTH loc,,n 


9PAC Monitor 


PZE loc,,n 


No 








Compiler 






PON loc,l,n 


No 




FORTRAN II 


PZE loc,,n 


Yes 









* n may be assumed to be 14 when it is omitted from the decrement field in $JOB/$ID calls. 
** prints error message if AC is minus but does not discontinue processing. 
*** KPOUT routine is entered when an error condition is encountered which necessitates discontinuing processing. 

Figure 45. Installation Accounting Routine Calling Sequence Parameter Words 



printed. In the distributed version of ibsys, sysacc 

contains: 

PZE 

If the accounting routine is to control printing of the 

$job and $id cards, sysacc must be patched with the 

following card: 

1 8 16 73 

SYSACC PZE any non-zero characters IBB42020 

If both sysacc and syspid ( see the section "syspid" ) 
are nonzero, the ibjob Monitor prints a special page 
heading on each page of the job listing. The data for 
the special heading is contained in a 10-word buffer 
which the user must provide. The location of the first 
word of the buffer must be placed in the address por- 
tion of sysacc The 10-word buffer must be in the 
following form: 

Words 1-2 Time of day 

Words 3-4 Date 

Words 5-7 Primary identification 

Words 8-9 Secondary identification 

(e.g., charge number) 
Word 10 Installation or run code 

The routine in ibjob that prints the special page 
heading is entered at symbolic location hed (ipcho6o). 

SYSPID 

Location syspid in the System Nucleus is used only by 
the ibjob Monitor. The ibjob Monitor tests syspid only 
if sysacc (see the section "sysacc") is found to be 
nonzero. The status of syspid determines whether the 
standard or special page heading is to be printed on 
the job listing. If syspid is zero, the standard heading 
is printed. If syspid is nonzero, the special page head- 



ing is printed. The 10-word buffer described in the 
"sysacc" section must be provided and a pointer to the 
buffer must be placed in sysacc if syspid is nonzero. 
If location syspid is to be changed, it must be patched 
with a card serialized IBB42030. 

Clock Reading Routine 

If the accounting routine is to contain a clock reading 
routine, either of the following clocks may be used: 

Core Storage Clock and Interval Timer - RPQF89349 (7090) 

orRPQ880295 (7094) 
Program Accounting Clock — RPQ78054 ( printer clock ) 

A routine which may be used to read the printer 
clock and print the reading on-line is included in Fig- 
ure 46. If the programmer wishes to write his own 
printer clock reading routine, he must be careful not 
to use ioex for this purpose because ioex has no facil- 
ities for "reading" the on-line printer. He must also 
ensure that the channel to which the printer is attached 
is dormant before attempting to read the printer clock. 

IOEX Message Writer 

The ioex Message Writer, .mwr, may be used to 
write accounting data on-line, off-line, or both ( see the 
section "Message Writer"). Care must be exercised in 
using the Message Writer for writing data off-line. 
Off-line messages are processed by a subroutine called 
spout, spout is loaded into upper core storage from 
sysend-199 to sysend ( see Figure 47) . When an account- 
ing routine is incorporated, sysend is moved back as 
shown in Figure 47. The Message Writer should not be 
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used to write off-line accounting data for any sub- 
system which does not recognize sysend-200 as the end 
of usable core storage (e.g., ibjob at object time). 

Incorporating an Accounting Routine into the 
System Monitor 

The process of incorporating an accounting routine 
in the System Monitor consists first of updating the 
Monitor and then reassembling it. The section "Re- 
assembling the System Monitor"gives instructions for 
updating and reassembling the System Monitor. 

There are two methods of incorporating an account- 
ing routine into the System Monitor. In the first method, 
the routine is loaded directly into its permanent resi- 
dence in upper core storage whenever the System 
Supervisor is loaded. In the second method, the routine 
is loaded first into lower core storage with the Super- 
visor and is only relocated to upper core storage at 
"cold start" time and when a subsystem returns control 
to the System Supervisor through location sysret. The 



details of these two methods and discussions of their 
respective advantages are given below. 

Method 1 

In this method the accounting routine is inserted into 
the System Supervisor with an org to sysend +1. The 
updating required to incorporate the accounting rou- 
tine requires patching at three locations in the System 
Monitor as described below: 

1. sysend is defined as —1 (i.e., 77777 8 ) in the dis- 
tributed version of ibsys. Since the accounting routine 
will occupy the final words of upper core storage, 
sysend must be redefined to the beginning of the 
routine minus 1. The patch card to redefine sysend 
must be in the following form: 

1 8 16 73 

SYSEND EQU ~(n+l) IBB00290 

( where n is the number of instructions in the account- 
ing routine. ) 
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Figure 47. Relationship of Installation Accounting Routine to spout Subroutine 



2. sysidr contains the instruction tra 2,4 in the dis- 
tributed version of ibsys. This instruction must be 
changed to a transfer to the accounting routine. The 
patch card to change this instruction must be in the 
following form: 



SYSIDR 



TRA 



16 
name 



73 
IBB41990 



(where name is the name of the entry point of the 
accounting routine, i.e., sysend + i.) 

3. The accounting routine is patched into the System 
Supervisor starting at serialization ibb66820, which is the 
highest serialization used in the Supervisor. In the 
distributed version of ibsys, the card with this seriali- 
zation contains the instruction tcd with an asterisk in 
the variable field. This instruction must be placed after 
the last instruction in the accounting routine. Its seriali- 
zation must be the next highest in sequence after the 
last instruction of the accounting routine. The block of 
instructions to be patched in at IBB66820 is: 



1 
name 



ORG 



16 
SYSEND + 1 



( installation accounting routine ) 



TCD 



73 
1BB66820 



IBBxxxxx 



( where ibbxxxxx is the next serial number in sequence 
after the last instruction of the accounting routine.) 
The principal advantage of Method 1 over Method 2 
( see the section "Method 2" ) is that Method 1 is some- 
what simpler. The principal disadvantage of Method 1 
is that each time the System Supervisor is called into 
core storage, the accounting routine is reloaded into 
upper core storage. This overlaying of the accounting 



routine with itself may cause difficulties in debugging. 
One such difficulty would occur if a subsystem over- 
laid part of the accounting routine. A dump would 
not reveal the overlaying because, when a call is made 
to the Core Storage Dump Program (sysdmp), the 
System Supervisor is loaded into core storage before 
sysdmp is loaded. Method 2 overcomes this disad- 
vantage. 

Method 2 

In this method the accounting routine is inserted into 
the System Supervisor with an org to a predefined loca- 
tion in the System Supervisor so that whenever the 
Supervisor is loaded into core storage, the accounting 
routine is loaded into that predefined area. A sub- 
routine, which the user must place at two locations in 
the System Supervisor, will move the accounting rou- 
tine to permanent residence in upper core storage at 
"cold start" time and whenever a subsystem returns 
control to the System Supervisor through location 

SYSRET. 

The updating required to incorporate the accounting 
routine requires patching at five locations in the Sys- 
tem Monitor as described below: 

1. sysend must be changed as described in Method 1. 

2. A routine to move the accounting routine from 
the System Supervisor to upper core storage must be 
placed at two locations in the System Supervisor. First, 
a move routine must be placed in the cold routine to 
move the accounting routine at "cold start" time. 
Second, a move routine must be placed in the tpps 
routine, which is entered whenever control is returned 
from a subsystem to the System Supervisor through 
location sysret. This move routine will restore the 
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accounting routine if it has been overlaid by a sub- 
system or an object program. A special routine may be 
written and inserted, or use may be made of a macro- 
operation (movldr) already available in the distrib- 
uted version of ibsys. To use this macro-operation insert 
the following card: 

8 16 73 

MOVLDR namel J name2,ACTORG IBBxxxxx 

(where namel is the name of the location of the first 
instruction of the accounting routine after relocation, 
i.e., sysend+i; name2 is the name of the last instruction 
plus 1 in the accounting routine after relocation, i.e., 
100000 8 ; actorg is the name of the first location into 
which the accounting routine is initially loaded, see 
item 4 below; and ibbxxxxx is ibbo7755 for the cold 
routine and ibb34590 for the tpps routine. ) This macro- 
instruction will generate the following routine: 



AXT 


name2-namel,l 


CAL 


ACTORG + name2-namel , 1 


SLW 


name2,l 


TIX 


* -2,1,1 



3. sysidr must be patched as described in Method 1. 

4. Storage allocation: The following card is included 
in the System Supervisor as distributed: 



ACTORG 



8 
BSS 



16 




73 
IBB47525 



It is at this location that the accounting routine will 
be loaded initially and from which it will be relocated 
to upper core storage. This card must be patched with 
the following: 



1 
ACTORG 



8 
BSS 



16 
n 



73 
IBB47525 



(where n is the number of instructions patched in at 
ibb66820; see item 5 below. ) 

5. The accounting routine is patched into the System 
Monitor in the same way as described in Method 1. 
The block of instructions to be patched in at IBB66820 
for Method 2 is: 



namel 



ORG 
LOG 



16 

ACTORG 
SYSEND + 1 



. ( installation accounting routine ) 



ORG 
TCD 



SYSORG 



73 

IBB66820 

IBB66830 



IBBxxxxx 
IBBxxxxy 



( where ibbxxxxx is the next serial number in sequence 
after the last instruction of the accounting routine and 
IBBxxxxy is the next serial number in sequence after 
ibbxxxxx. ) 

Figure 46 is a listing of a sample deck showing the 
five patches required for updating the System Monitor 
to incorporate an accounting routine by Method 2. The 
accounting routine shown (starting with actbeg+i and 



ending with actend) is not a complete installation 
accounting routine. It comprises only a tested clock 
reading routine that uses the printer clock. 

The principal advantage of Method 2 over Method 1 
is that the accounting routine is not overlaid before a 
sysdmp dump is taken. The principal disadvantage is 
that the amount of upper core storage occupied by the 
System Supervisor is increased by the size of the ac- 
counting routine, and the time for executing Supervisor 
calls via sysret is increased by the time required to 
move the accounting routine. 

Incorporating an Accounting Routine into a Subsystem 

If an accounting routine is designed for use only with 
a specific subsystem, the accounting routine should be 
assembled and then appended to the first record of the 
subsystem by using an *modify card when editing the 
System Library ( refer to the section "System Editor" ) . 
This will result in the accounting routine being loaded 
whenever the first record of the subsystem is loaded, 
that is, after a sexecute card containing the name of 
the subsystem is read. The first record of the subsystem 
should also be appended to overlay the sysidr location 
in the Communication Region of the System Nucleus 
so that the location contains a transfer to the beginning 
of the installation accounting routine. If necessary, the 
syscor location should be overlaid in order to change 
the address portion of the entry which defines the end 
of usable core storage. The sysacc location may also 
be overlaid if it is desired to control printing of the 
$job and $id cards. 

A $ibsys card, followed by a srestore card, should be 
placed at the end of a job or job segment performed by 
a subsystem containing an accounting routine if it is 
followed on the system input file by jobs or job seg- 
ments to be performed by other subsystems or by the 
System Monitor. The srestore card will restore sysidr, 
syscor, sysacc, and syspid locations to their original 
state, thereby nullifying any changes made by the 
subsystem containing the accounting routine. 



Incorporating User Programs as Subsystems 
Under System Monitor Control 

A user may, if he chooses, design a program and insert 
it in the System Library. The program can then be 
called into core storage by a sexecute card and can be 
executed. Once the program is coded and assembled, 
it may be inserted in the System Library using a job 
deck similar to the sample job deck in Figure 48. 

For the sample job deck, it is assumed that a user 
program, which is named systmu, is located on sysut3 
in the form of absolute column-binary card images that 
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Figure 48. Sample Job Deck for Inserting a User Program as a 
Subsystem Under Monitor Control 



terminate with a transfer card. The job deck is designed 
to insert the program in the System Library immedi- 
ately following the ibjob Processor. Before the program 
is inserted, it is converted by the System Editor into a 
self-loading, scatter-load format, which is a standard 
format for the System Library. For the sample job deck 
in Figure 48, it is assumed that the user program con- 
sists of one record only. However, a program may 
consist of more than one record. For each additional 
record, another tape *insert card must be placed in 
the job deck and the absolute column-binary card 
images from which the record is formed must follow 
(on sysut2) the card images for the previous record. 
The column-binary card images for each record must 
end with a transfer card. Additional information may 
be found in the section "System Editor." 

In designing and coding a program for insertion as 
a subsystem in the System Library, a number of rules 
must be adhered to in order to ensure proper loading 
of the program, coordinated control of input/output 
operations, and continuous job processing. These rules 
are as follows : 

1. The program must use the core storage between 
sysobg and sysend only (refer to syscor in Appen- 
dix A). 

2. The first word in the first record of the program 
must be a bcd name without leading blanks and may 
have an origin at syscur (Appendix A). This name is 
the name of the program and is the name specified on 
the $execute card to call the program. The name must 
not be the same as the name of any other record in the 
System Library. 

3. The first word of the second and succeeding rec- 
ords, if any, of the program must be a unique bcd 
name, without leading blanks, and may have an origin 

at SYSCUR. 

4. The first record must contain a tra instruction, 
which transfers control to the beginning of the pro- 
gram and which has an origin at systra (Appen- 
dix A). 

5. The System Loader (sysldr) in the System Nu- 
cleus may be used by a program to load the second 
and succeeding records of the program. In Appendix 



A, a description of the use of the System Loader may 
be found under "sysldr." If the System Loader is used 
to load a record, the contents of systra must be 
changed to transfer control to the first instruction that 
is to be executed after the record is loaded. This may 
be accomplished by placing in the record itself a tra 
instruction which has an origin at systra. The instruc- 
tion will then overlay the content of systra when it 
is loaded. 

6. The program must recognize and act upon the 
sibsys, sexecute, $stop, $id, and $job cards, as described 
in the section "System Nucleus" under the heading 
"Job Control Communications with Subsystems." 

7. If a system unit is to be used, it must be re- 
ferred to by way of its entry in the System Unit Func- 
tion Table and, if it is a direct access storage unit, 
by its entry in the Disk/Drum Limits Table (refer to 
the section "System Nucleus" ) . 

8. If a unit that is not assigned to a system unit 
function is to be used, it must be referred to by way 
of an availability chain (refer to the section "System 
Nucleus" ) . 

9. The program must either use ioex (described in 
the section "Input/Output Executor") or adhere to 
the following rules: 

a. If a 729 Magnetic Tape Unit or 7340 Hypertape 
Drive is used, the program must keep track of 
the file and record count in the unit control 
block of the unit. 

b. Before using the System Loader, the program 
must make certain that there is no activity on 
the channel that is being used. 

c. If the System Loader is used to load records 
from direct access storage, the program must 
not overlay ioex routines ( fdamt, ( decvd, and 
(decrq. 

Incorporating IBM Modifications to the 
7090/7094 IBSYS Operating System 

The 7090/7094 ibsys Operating System is distrib- 
uted preassembled in binary form on a single 729 capa- 
bility System Library Tape and in symbolic form on 
several tapes. Each of the symbolic tapes will normally 
contain more than one subsystem. However, since the 
System Monitor and each of the subsystems are main- 
tained separately, instructions will be provided, when 
the symbolic tapes are distributed, for copying the 
System Monitor and each subsystem onto separate 
tapes. Whenever modifications are to be made to the 
System Monitor or a subsystem, a modification letter 
will be distributed. Two job decks will be distributed 
with the letter; a symbolic modification deck and a 
binary modification deck. Either deck may be used to 
produce a new binary System Library for 729 capability 
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with the required modifications incorporated. However, 
the symbolic modification deck will also produce an 
updated symbolic tape of the subsystem ( or the System 
Monitor) being modified and a symbolic assembly 
listing of the portions of the subsystem that are updated 
and reassembled to incorporate the modifications. 
Those subsystems or components which have been 
reassembled for disk, drum and/or Hypertape capa- 
bility can be maintained only with the symbolic modi- 
fication deck issued with ibm modification letters. In 
these cases, the binary modification deck is not ap- 
plicable because of address considerations. In addition 
to the symbolic and binary modification decks, a third 
job deck, the ibsys Cumulative Editor Deck will be 
distributed whenever a new version of the 7090/7094 
ibsys Operating System is released. This deck may be 
used to accumulate modification cards from several 
binary modification decks and may be used, at any 
time, to bring a System Library up to the latest modi- 
fication level in a single job run. Again, it cannot be 
used for modifying systems with disk/drum and/or 
Hypertape capability. 

Any one or a combination of the three methods rep- 
resented by the three job decks may be used at an in- 
stallation to maintain the System Library, depending 
upon the particular requirements of the installation. 



Symbolic Modification Deck 

The symbolic modification deck distributed with each 
modification letter will be written in one of three 
standard forms. If the portion of the system being 
modified is written in the Macro Assembly Program 
(map) language (System Monitor, System Editor, 
ibjob Processor, Utilities, or Restart Program), a deck 
similar to the one shown in Figure 49 will be used. In 
the case of modifications to the ibjob Subroutine 
Library (iblib), a special symbolic deck will be dis- 
tributed which is intended for use with this component 
of the ibjob Processor only. A model of this deck will 
be found in Figure 50. If the portion of the system 
being updated is written in the fobtban ii Assembly 
Program (fap) language (Independent iocs), a deck 
similar to the one shown in Figure 51 will be used. In 
all cases, the deck accompanying a modification letter 
will contain symbolic modification cards for updating 
a subsystem or the System Monitor in addition to the 
control cards listed in Figures 49, 50, and 51. 

All three symbolic modification decks are designed 
for use with a System Library having the same system 
unit assignments ( Figure 28 ) as the distributed System 
Library Tape. If system unit assignments and density 
settings have been changed at an installation, it may 
be necessary to change one or more of the $attach 
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Figure 49. Symbolic Modification Deck for Updating MAP-Assembled System Components 
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Figure 50. Symbolic Modification Deck for Updating the ibjob Subroutine Library 



cards in the beginning of the deck accompanying a 
modification letter. 

The assignment and function of tape units for the 
symbolic modification deck used for updating map 
coded portions of the system (excluding the ibjob 
Subroutine Library ) are shown in Figure 52. Those for 
the ibjob Subroutine Library are shown in Figure 53 
and those for the symbolic modification decks used for 
updating fap coded portions of the system are shown in 
Figure 54. 

The starting procedure for each of the three sym- 
bolic modification decks is the same. The old System 
Library Tape, containing the subsystem (or the Sys- 
tem Monitor) to be modified, is mounted on syslbi 
( tape unit ai ) . The old symbolic tape, with the sub- 
system (or the System Monitor) to be modified at the 
beginning of the tape, is mounted on sysuts (tape 
unit A4 ) . The symbolic modification deck is placed on 



the system input tape on sysini (tape unit as). Follow 
the initial start procedure described in the publication 
IBM 7090/7094 IBSYS Operating System: Operators 
Guide, Form C28-6355. 

At the completion of any of the symbolic modifica- 
tion jobs, the new System Library Tape will be found 
on sysuti (tape unit A3), the assembly listing of the 
updated and reassembled portions of the subsystem 
on sysoui (tape unit bi), and the updated symbolic 
tape for the subsystem (or System Monitor) on 
sysut2 (tape unit B3). The density and unit function 
assignments for all units used by the symbolic modi- 
fication decks are assumed to be as distributed (see 
Figure 28). If these system unit functions have not 
been modified, the physical tape units specified above 
will be valid for the functions designated, regardless 
of which form of the symbolic modification deck is 
used. 
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Figure 51. Symbolic Modification Deck for Updating fap- Assembled System Components 
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Figure 52. The Assignment and Function of Units for Symbolic 
Modification Decks Used for Updating MAP-Assem- 
bled Systems 



Figure 53. The Assignment and Function of Units for Symbolic 
Modification Decks Used for Updating the ibjob 
Subroutine Library 



The operations performed by each of the symbolic 
modification decks are listed below: 

Operations Performed by Symbolic Modification 
Decks Used for Updating MAP Subsystems: The follow- 
ing operations are performed by the symbolic modifica- 
tion decks that are used to update portions of the system 
written in the Macro Assembly Program (map) lan- 
guage: 

1. Tape unit A4 is attached as syscki to function as 
the update input tape. 
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Figure 54. Assignment and Function of Units for Symbolic 
Modification Decks for FAP-Assembled Systems 
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2. Tape unit B3 is attached as sysck2 to function as 
the update output tape. 

3. The portion of the subsystem on the symbolic 
tape on syscki that requires modification is updated 
with the symbolic modification cards in the job deck 
on sysini and is written on sysck2. The unchanged 
portions are copied onto sysck2, after which a sstop 
card with high serialization and an end-of-file mark 
are written. 

4. The updated portions are assembled as an alter- 
nate input file on sysck2 by the map Assembler and 
written in binary form on sysppi. The assembly listing 
is placed on sysoui. 

5. Tape unit B2 (sysppi) is attached as sysut2 in 
preparation for editing. 

6. The System Library is edited to incorporate the 
updated and reassembled portions of the subsystem 
that are in binary form on sysut2. The following Sys- 
tem Editor control card is normally used: 

TAPE *REPLACE ( record name ) 

In some cases, the following System Editor control 
card may be used: 

TAPE *MODIFY (record name) 

Operations Performed by Symbolic Modification 
Decks Used for Updating the IBJOB Subroutine Li- 
brary: The following operations are performed by the 
symbolic modification deck that is used to update the 
ibjob Subroutine Library: 

1. Tape unit A4 is attached as syscki to function as 
the update input tape. 

2. Tape unit B3 is attached as sysck2 to function as 
the update output tape. 

3. The routines of the ibjob Subroutine Library on 
the symbolic tape on syscki that require modifications 
are updated with the symbolic modification cards in 
the job deck on sysini and written on sysck2. The un- 
changed portions are copied onto sysck2, after which 
an end-of-file mark is written on sysck2. 

4. A second and final update creating a system input 
tape is performed on the symbolic update output tape 
on sysck2. The Library subroutines which must be as- 
sembled are extracted and placed on sysuti, along 
with the proper control cards to perform a Librarian 
and ibsys system edit to place the new ibjob Subroutine 
Library on the System Library Tape. 

5. Instructions for the operator are provided on the 
on-line printer to make the appropriate tape changes 
to allow the new system input tape prepared in phase 4 
of the job to be run against the System Library Tape. 
Old and new symbolic tapes should now be removed 
and retained. 

6. The appropriate routines are assembled by the 
ibjob Processor, a Librarian edit is performed, and an 
ibsys system edit is done from sysut4, producing a Sys- 



tem Library Tape on sysuti (tape unit A3) with a new 
ibjob Subroutine Library. It should be noted that the 
symbolic output tape created in phase 3- of the job on 
sysck2 is the symbolic tape which will be used with 
future modifications to the ibjob Subroutine Library. 
Operations Performed by Symbolic Modification 
Decks Used for Updating FAP Subsystems: The fol- 
lowing operations are performed by the symbolic modi- 
fication decks that are used to update portions of the 
system written in the Fortran ii Assembly Program 
(fap) language: 

1. Tape unit A4 is attached as syscki to function as 
the symbolic update input tape, and tape unit B3 is 
assigned to sysck2 to function as the symbolic update 
output tape. 

2. The two functions sysuti and sysut3 are as- 
signed to tape unit A3. In addition to the normal list 
output on sysoui, the job deck produces a new System 
Library Tape and an updated symbolic tape of the 
subsystem being modified. 

3. The System Peripheral Punch tape is rewound. 

4. The symbolic tape of the subsystem, at the pre- 
vious modification level, is copied from syscki onto 
sysck2 (without assembly) up to the portion that re- 
quires modification. 

5. The portion of the subsystem on the symbolic 
tape on syscki that requires modification is updated 
with the symbolic modification cards in the job deck 
on sysini and is written on sysck2. The updated portion 
is assembled and then written in binary form on 
sysppi. The assembly listing is placed on sysoui. 

6. The remainder of the old symbolic tape on syscki 
is copied ( without assembly ) onto sysck2, after which 
an end-of-file mark is written. 

7. sysppi, which contains the updated and assembled 
portions of the subsystem, is switched with sysut2, in 
preparation for editing onto the new System Library 
Tape. The new symbolic tape is on the unit that is 
now assigned as sysppi, and may be saved. 

8. The updated symbolic tape on syscki is rewound 
and unloaded. 

9. The System Library is edited to incorporate the 
updated and reassembled portions of the subsystem 
that are in binary form on sysut2. The following Sys- 
tem Editor control card is normally used: 

TAPE *REPLACE (record name) 

In some cases, the following System Editor control 
card may be used: 



TAPE 



♦MODIFY (record name) 



Binary Modification Deck 

The basic control cards in a standard binary modifica- 
tion deck are listed in Figure 55. In addition to these 
cards, each distributed deck will contain one or more 
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System Editor *modify and/or *replace cards and 
a number of column-binary alteration cards (Figure 
18) for modifying a subsystem or the System Monitor. 
This deck can be used without change to produce a 
new System Library Tape from the System Library 
at the previous modification level. An *check card is 
included in the deck to verify that the correct number 
of *modify, *replace, and column-binary alteration 
cards have been received. 

The *modify, *replace, and column-binary altera- 
tion cards in the deck are serialized in columns 73 
through 80. The serialization indicates the order, in 
the System Library, of the record being modified 
and has the following format: 

AABCCDDD 
where aa is the order in the System Library of the 
subsystem (or System Monitor) being modified, plus 
10. For example, the System Monitor is 11, the ibjob 
Processor is 12, the Symbolic Update Program is 13. B 
is the number of a file within the subsystem, cc is the 
number of a record within the file, and odd is the num- 
ber of a column-binary alteration card or an *modify or 
^replace card. For the *modify and *replace cards, 
ddd is always 000. As an example, the cards for modify- 
ing the first record (ibmapj) of the fourth file' of the 
ibjob Processor are serialized as follows: 



♦MODIFY IBMAPJ 

( First alteration card ) 
( Second alteration card ) 
( Third alteration card ) 



12401000 
12401001 
12401002 
12401003 



The same type of serialization is used for the main- 
tenance control cards in the System Editor portion 
of the symbolic modification deck shown in Figure 46. 

IBSYS Cumulative Editor Deck 

The basic control cards in the ibsys Cumulative Editor 
Deck are listed in Figure 56. This deck is distributed 
whenever a new version of the 7090/7094 ibsys Op- 
erating System is released. After each binary modifica- 
tion deck is received, modification cards from the deck 
may be removed and placed in the Cumulative Editor 
Deck. Instructions for doing this will be provided in 
each modification letter. The cumulative deck may be 
used to produce a System Library Tape at the current 
modification level from a backup System Library Tape. 
Use of the cumulative deck facilitates the determina- 
tion of System Library modification levels, since the 
modification cards for the System Monitor and all 
subsystems are included in one deck. 

Occasionally, it may be necessary to perform a 
special edit to modify library subroutines, using edit- 
ing facilities in the ibjob Processor, the Fortran ii 
Processor, or the Commercial Translator Processor. 



$J0B 

$• IBJOB FORTRAN IV COMPILER (IBFTC) 

SIBEDT 

•EDIT HAPfHOOS 

(MODIFICATION CAR0S) 
•CHECK N 
(ENO-OF-FILE CARD) 
$STOP 



7090-FO-805, VERSION 3, MOD. 2 



VERIFY THAT N CARDS HAVE BEEN RECEIVED. 



00000001 
00000008 
00000030 
00000031 
AABCCDDD 
98999999 
99000000 
99000001 



Figure 55. Binary Modification Deck 
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Figure 56. ibsys Cumulative Editor Deck 
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When this is necessary, a special modification deck is 
distributed. However, the cards from these special 
decks should not be incorporated in the Cumulative 
Editor Deck. In particular, see the first modification 
letter issued to the ibjob Subroutine Library after the 
release of a new version for details concerning the iblib 
Cumulative Editor Deck. 

The user may keep a copy of the distributed System 
Library Tape as a backup tape and use it and the 
Cumulative Editor Deck whenever it is necessary to 
produce a System Library Tape at the current modi- 
fication level. If a special modification deck is distrib- 
uted, it may be used to produce a new backup System 
Library Tape from the old one. The new backup tape 
and the Cumulative Editor Deck may then be used, 
when necessary, to produce an up-to-date System 
Library Tape. 

Maintaining a Two-Tape System Library 

Some installations may use a two-tape System Library, 
in which parts of the ibjob Processor are located on a 



second System Library Tape. To incorporate ibm 
modifications without changing the distributed mod- 
ification decks, a duplicate of the System Library 
should be maintained on a single tape reel. After mod- 
ifications are incorporated in the single System Library 
Tape, it may be used to produce a two-tape System 
Library, in which parts of the ibjob Processor are lo- 
cated on a second tape. A discussion of the use of 
multiple library units is contained in the publication 
IBM 7090/7094 IBSYS Operating System: IBJOB 
Processor, Form C28-6389. 



7320 Drum Update-Edit Decks for IBJOB 

The 7320 Drum Update-Edit Decks are designed to 
serve as a guide for providing ibjob system residence 
on 7320 Drum Storage. These decks are shown in Fig- 
ures 57 and 58. 

Edit Deck Number 1 splits the ibsys Operating Sys- 
tem, on a 729 Disk/Drum/Hypertape-Capability Sys- 
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Figure 57. 7320 Update-Edit Deck Number 1 
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Figure 58. 7320 Update-Edit Deck Number 2 

tem Library Tape, between a 7320 drum and a 729 
System Tape. The ibsys System Monitor, the ibjob 
Monitor (minus the ibjob Subroutine Library 
(iblib) ), and the ibsys Editor are edited onto a 
7320 drum, while the ibjob Subroutine Library and 
all other subsystems under the ibsys Operating Sys- 
tem are edited onto a 729 tape. This 729 System Library 
Tape (syslb2) is used in conjunction with those sys- 
tems edited onto the 7320 drum. Edit Deck Number 1 
accomplishes this split of the ibsys Operating System 
with no assembly or reblocking of components required. 



2M000040 
20000100 
2P000100 
2Q000100 
2SO001O0 



Octal modification cards are included in deck num- 
ber 1 for the ibsys and ibjob records to modify the 
system to do the following: 

1. Attach tape unit ai as syslb2. 

2. Modify the ibjob action table to indicate that 
iblib is on syslb2. 

A one-pass ibedt is performed. During this edit, 
syslb2 is created on tape unit A4. A map of the sys- 
tem as it resides on 7320 drum and on a 729 tape is 
written on the system output tape. At the end of the 



76 



edit run syslbs ( on tape-unit A4 ) should be manually 
switched to tape unit ai. A drum load card, punched 
on-line during the course of the job, should be used to 
initiate the operation of the split system. 

Figure 59 is a summary of the input/output assign- 
ment for Edit Deck Number 1. 



UNIT 


ASSIGNMENT 


FUNCTION 


Al 


SYS LB 1 


729/1301/7320 System Library (see Note) 


A2 
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Not Used 


c Nam/s 


SYSUTI 


New System Library (SYS LB 1) 



(where c = channel, N = NEED DRUM, a= access arm, m = module, 
s= data channel switch) 

NOTE: The System Library must contain the IBSYS modifications for the 
installation 7909 channel configuration. In particular the IBSYS 
record must contain the parameters specifying the 7320 drum con- 
figuration. 

Figure 59. Summary of Input/Output Assignments for the 7320 
Edit Deck Number 1 

If an installation has two or more 7320 drums, the 
7320 Update-Edit Deck Number 2 may be used to 
reassemble ibldr and reblock iblib to a block size of 
524 words to allow full track iblib residence on drum. 
Library records of 524 words will require approxi- 
mately 12 less drum tracks for iblib residence and is 



only required if space on a drum is limited. A single 
system tape is produced as a result of applying this 
deck to a previously prepared System Library Tape 
with disk, drum, and/or Hypertape capability. An 
individual user may arrange the components on drums 
as desired, by preparing his own edit deck. 

Symbolic modifications are included in ibldr to al- 
low full track residence of iblib on 7320 drum. The 
Update-Edit Deck Number 2 operates in five phases: 

Phase 1 Updates IBLDR with the correct parameters to proc- 
ess subroutine blocks of 524 words when assembled. 

Phase 2 Assembles the updated IBLDR. 

Phase 3 Generates an intermediate System Library Tape with 
the reassembled IBLDR replacing the distributed 
IBLDR. 

Phase 4 Reblocks IBLIB to a block size of 524 words. 
Phase 5 Generates final System Library Tape by replacing 

distributed IBLIB with reblocked IBLIB through an 

IBSYS edit. 

Following both phases 1 and 2 a stop occurs, at 
which time the symbolic input tape and symbolic out- 
put tape for ibldr are removed from tape units A3 and 
B3 respectively and replaced by work tapes. 

At the end of the run, the new System Library, 
syslbi, is on tape unit A3. Punch output of the assembly 
of ibldr is destroyed by phase 3. If this output is de- 
sired, a pause should be inserted in the deck following 
phase 2, and the tape on B2 should be removed and 
replaced with a work tape. Figure 60 gives a sum- 
mary of input/output assignments for Edit Deck Num- 
ber 2. 
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NOTE: The System Library must contain the IBSYS modifications for the instal'^tion 7909 channel configuration. In particular 
the IBSYS record must contain the parameters specifying the 7320 drum configuration. 

Figure 60. Summary of Input/Output Assignments for the 7320 Edit Deck Number 2 
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Appendix A: System Nucleus Communication Region Entries 



The functions of the entries in the Communication 
Region of the System Nucleus are described in this 
appendix. 

SYSTRA is loaded with a transfer instruction when 
the first record of a subsystem is scatter-loaded into 
core storage following the reading of a sexecute card. 
After the loading of the first record of a subsystem is 
completed, the System Loader transfers control to 
this entry, which, in turn, transfers control to the be- 
ginning of the subsystem. A transfer instruction may 
also be loaded in this location when succeeding rec- 
ords of a subsystem are loaded. 

SYSDAT contains a six-character word containing 
the date specified on the last sdate card processed. The 
entry should be updated by a $date card at the be- 
ginning of each day. The date word is provided for 
use in headings and labels by subsystems and object 
programs. 

SYSCUR contains the name, in bcd form, of the sub- 
system or subsystem record currently in core storage. 
The System Supervisor places the subsystem name 
from the sexecute card in this location before loading 
the first record of the subsystem. When succeeding 
records of a subsystem are loaded, the name of the 
record may be loaded into this location. 

SYSRET is the location to which each subsystem 
transfers control to call in the System Supervisor. 
Once the System Supervisor is called into core storage, 
the instruction emtm is executed. Therefore, the ma- 
chine is always in the multiple-tag mode when control 
is passed to a subsystem from the System Supervisor. 
SYSKEY is the location in which the entry key set- 
tings are stored at initial start. This location may be 
interrogated to determine what the status of the entry 
keys was before initial start. 

SYSSWS is the location in which sense switch set- 
tings are stored at initial start. Sense switches 1 
through 4 are reserved for use by the Operating 
System. This location may be interrogated to deter- 
mine what the status of the sense switches was before 
initial start. Bits 30 through 35 of the entry represent 
sense switches 6 through 1, respectively. A 1-bit indi- 
cates that the corresponding sense switch was down 
at initial start. 

SYSPOS contains the number of the System Library 
Unit and the position on the unit of the subsystem 
currently in core storage. This information is entered 
in the syspos location by the System Supervisor after 
it looks up, in the System Name or System Loader 



Table, the position of a subsystem specified on the 
sexecute card. When the System Library is on tape, 
the format of the entry is as follows: 

PZE INDEX„NFILES 

where index is 1, 2, 3, or 4, corresponding to syslbi, 
2, 3, or 4, and nfiles is the number of files the System 
Supervisor must skip over before loading the first rec- 
ord of the subsystem. 

When the System Library is on disk or drum, the 
format of syspos entry is as follows : 

PZE INDEX„L(SYSNAM) 

where index is the same as previously described and 
l(sysnam) is the binary disk or drum track location 
of the subsystem. 

SYSUNl contains the first location (in the address 
portion) and length (in the decrement portion) of the 
System Unit Function Table. The Disk/Drum Limits 
Table is assembled in the core-storage locations im- 
mediately following the System Unit Function Table. 
SYSUBC contains the first location (in the address 
portion) and length (in the decrement portion) of the 
Unit Control Block Table. This table consists of one 
word for each channel containing the following in- 
formation : 

Prefix Number of card units assigned to the 

channel. 
Decrement Total number of units assigned to 

the channel. 
Address Address of the first unit control block 

for the channel. 
SYSUAV contains the first location (in the address 
portion) and length (in the decrement portion) of the 
Unit Availability Table. This table is described in the 
section "System Nucleus" under the heading "Unit 
Availability Table." 

SYSUCW contains the first location (in the ad- 
dress portion) and the combined length (in the decre- 
ment) of all unit control blocks. The unit control 
blocks are assembled in contiguous locations. 

SYSRPT contains a transfer instruction to a System 
Nucleus routine that detemines whether the System 
Supervisor or the subsystem receives control when a 
$job card is read by a subsystem. When a subsystem 
reads a $job card, it transfers to sysrpt. If the sign of 
sysjob is minus, indicating that restoration of unit 
assignments is required, or if sense switch 1 is down 
and the card reader is not assigned as the System 
Input Unit, indicating that a between-jobs interrupt 
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condition exists, control is passed to the System Super- 
visor. Otherwise, control is returned to the subsystem 
that read the $job card. 

SYSCEM normally contains the following instruc- 
tion: 



TRA 



SYSTRA-2 



This location is reserved for use by the customer 
engineer. During machine maintenance periods, it 
may contain a transfer to a customer engineering 
diagnostic routine located in core storage between 
sysorg- 50 and sysorg-i. The diagnostic routine is 
transferred to this area by the System Supervisor at 
initial start and when a $restore card is processed. 

SYSDMP contains a transfer to a bootstrap routine 
for loading the System Core-Storage Dump Program, 
which is part of the System Monitor ( ibsys ) file on 
syslbi. A transfer to sysdmp initiates a core-storage 
dump in accordance with the options selected by the 
programmer or operator. (Additional information is 
contained in the section "System Core-Storage Dump 
Program.") The dump spill tape unit is syspp2. Neither 
sysoui nor syspp2 can be disk or drum. 

SYSIOX contains the first location (in the address 
portion) and length (in the decrement portion) of the 
ioex Communication Table (Figure 16). This table 
contains entries for transferring control to ioex sub- 
routines. 

SYSIDR is provided for transferring control to an 
installation accounting routine. Whenever a $id or $job 
card is processed by a subsystem or the System Moni- 
tor, a transfer is made to sysidr, as follows: 

TSX SYSIDR,4 

PZE L($ID) 

return 

where l($id) is the location of the first word of the 
buffer containing the $id or $job card in bcd form. In 
the distributed version of the System Monitor, sysidr 
contains: 



TRA 



2,4 



Therefore, control is returned immediately to the 
subsystem (or to the System Monitor) that processed 
the $id or $job card. If an installation accounting rou- 
tine exists at an installation, sysidr should contain a 
transfer to the routine. 

SYSCOR contains the limits of the core-storage 
area available for use by subsystems operating under 
control of the System Monitor. 



PZE 



SYSEND„SYSORG 



In the distributed version of the System Monitor, 
sysend and sysorg are defined as follows: 

SYSORG = 2652 8 or 1450 lo 
SYSEND = 77777 8 or 32,767 w 



The Fortran ii Processor does not refer to location 

syscor when defining the two symbols sysorg and 

sysend. These symbols are defined by Fortran ii as 

follows: 

SYSORG = 3720 8 or 2000,0 
SYSEND = 77777b or 32,767™ 

The user may redefine sysend to allow space for an 
installation accounting routine in upper core storage. 
In this case, the following limits apply: for Fortran 
ii, sysend may not be lower than 77677 8 or 32,703i ; 
for all other subsystems, sysend may not be lower than 
77013 8 or 32,267 10 . 

SYSLDR contains a transfer to the System Loader. 
The System Loader may be used to scatter-load sub- 
system records that have the same standard System 
Library record format as the first record of the sub- 
system. Each iocp command used by the System 
Loader must have a word count no greater than 
37777) 8 and must be in the transmitting mode ( bit 
19 off). When loading is completed, the System 
Loader transfers to the systra location. Therefore, 
the contents of systra must be modified during or 
prior to loading. 

Whenever the first record of a subsystem is loaded 
into core storage following the reading of a sexecute 
card, the System Supervisor places in the decrement 
portion of sysldr the location of the unit control block 
for the unit from which the subsystem is being 
loaded. Subsequent transfers to sysldr by the sub- 
system will result in the next sequential record being 
loaded from the unit indicated in the decrement por- 
tion of sysldr. Therefore, if the decrement of sysldr 
is not changed by the subsystem, the next record of 
the subsystem will be loaded from the same unit as 
the previous record, each time a transfer is made to 

SYSLDR. 

When the subsystem being loaded is on direct 
access storage, the System Loader routine obtains the 
track address of the next sequential record from the 
decrement of systch (described later in the text). 
When editing records onto disk or drum, the System 
Editor appends to each record a tch syscyd command 
containing the track address of the next record in its 
decrement. When a record is loaded from direct 
access storage by the System Loader, the tch com- 
mand at the end of the record ends up in systch, 
where it is availabe for loading the next record. 

A subsystem may specify the unit from which the 
next record is to be loaded by changing the unit con- 
trol block address in the decrement portion of sysldr. 
However, the unit must be on the same channel ( and 
Data Channel Switch setting if it is a 7909 Channel) 
as the unit from which the first record of the subsystem 
specified on the sexecute card was loaded. When load- 
ing from direct access storage, the decrement of 
systch must also be changed. 
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The System Loader may be entered using the follow- 
ing instruction: 

TSX SYSLDR,4 

If syslbi is direct access storage and the System 
Supervisor that processed the last $execute card was 
loaded from direct access storage, an alternate entry 
may be made to the System Loader by using the fol- 
lowing sequence: 



TSX 
BCI 



SYSLDR,4,1 
1,SYSREC 



where sysrec is the name of a record on syslbi. When 
this entry is made, the System Loader will load the 
record specified by sysrec. The System Loader obtains 
the track address of the specified record from the 
System Loader Table ( sltabl ) . This table is generated 
and placed in the System Library when it is edited 
onto direct access storage by the System Editor. To 
obtain the track address, the System Loader writes a 
checkpoint record on syslbi (just behind the System 
Core-Storage Dump Program), loads the System 
Loader Table into core storage, looks up the address 
of the specified record in the table, and restores core 
storage. 

SYSACC is used for communication between the 
installation accounting routine (if one exists), and 
the subsystems and System Monitor. In the distributed 
version of the System Monitor, this location contains 
the following: 



PZE 



0,0,0 



Whenever a $id or $job card is processed by a sub- 
system or the System Monitor, sysacc is tested before 
a transfer is made to sysidr. If sysacc contains all 
zeros, the subsystem or System Monitor lists the $id 
or $job card on the System Output and System Printer 
Units before transferring to sysidr. In the case of a 
sjob card, a page eject is performed before the card 
is listed. If the contents of sysacc are nonzero, the 
siD or $job card is not listed before the subsystem or 
System Monitor transfers to sysidr. The installation 
accounting routine is provided with the location of 
the first word of the buffer containing the $id or $job 
card (as described previously under. sysidr) and must 
list the card if sysacc is set to nonzero at an installation. 



SYSPID is reserved for use in communication be- 
tween an installation accounting routine, when one is 
incorporated in the ibsys Operating System, and the 
subsystems and the System Monitor. The exact use 
of this location depends on the design of the installa- 
tion accounting routine. In the distributed version of 
the Operating System, syspid is not used. 

SYSCYD and SYSCYD+1 contain the following 
input/output commands, which are used by the Sys- 
tem Loader when subsystem records are loaded from 
disk, drum, or Hypertape. 

SYSCYD CPYD 0„0 

TCH SYSTWT 

SYSSLD, SYSTCH, and SYSTCH+1 contain the 
following input/output command sequence, which is 
used by the System Loader for scatter-loading sub- 
system records: 

SYSSLD CPYP * + l„l (IOCP) 

SYSTCH WTR * + l 

TCH *-2 

Upon completion of loading from direct access 
storage via the System Loader, systch will contain a 
tch command whose decrement will contain the track 
address of the next sequential record on disk or drum. 

SYSTWT contains a twt instruction which serves 
as a common 7909 channel transfer point for all users 

of IOEX. 

SYSGET contains a word that indicates to the Sys- 
tem Supervisor why control was returned to it by a 
subsystem. Additional information on sysget is con- 
tained in the section "System Nucleus." 

SYSJOB contains a control word that is used by the 
System Supervisor and the subsystems in controlling 
the skipping of jobs and job segments. Additional in- 
formation on sysjob is contained in the section "System 
Nucleus." 

CHEXI is the Direct-Couple-environment indicator 
location. An indirect zero test of this location (zet* 
chexi ) by a subsystem indicates the current opera- 
tional mode of the system. A successful zero test indi- 
cates direct mode d-c environment. 

.MODSW is a Direct-Couple cell which indicates to 
ioex whether the next record is in bcd or binary mode. 
If the contents are zero, binary mode is indicated; if 
nonzero, bcd is indicated. 
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Appendix B: Routine to Perform an IOEX Read or Write Using 729 Tape 



THE FOLLOWING EXAMPLE IS SOLELY FOR THE PURPOSE OF ILLUSTRATION. 
IT DOES NOT REFLECT BUFFER TECHNIQUES IN USE OF 7607 CHANNEL. 



SAMPLE ROUTINE PERFORM READ OR WRITE FROM TAPE USING IOEX 

CALLING SEQUENCE 

TSX I0XRW.4 

P LOCFIL,M,RCHSEQ 

PZE EOF,, ERR EOF OR EOT OR ERROR RETURNS 

WHERE... 

P IF MINUS, WRITE IF PLUS, READ 

BIT 1 IF I, NO MESSAGE IF 0, MESSAGE 

LOCFILE LOCATION OF A WORD WITH UCB IN ADDRESS (INDIR. REF. ) 

M IF BC0.1 IF BINARY, 

RCHSEQ LOCATION OF I/O COMMANDS (ENDING IN TRAP) 

EOF END OF FILE OR TAPE EXIT 

ERR ERROR EXIT 

INDICATORS AND ACC ARE DESTROYED. IRS ARE SAVED. 



IOXRW 



IOXND 

I0XS4 
IOXEF 
IOXER 



SXA 
CLA 
STA 
ARS 
STA 
CAL 
STT 
STP 
STA 
STA 
LAC 
ARS 
STA 
CLA 
ZET 
TRA 
STO 
STZ 
TSX 
PZE 
NZT 
TRA 
LDI 
AXT 
LFT 
TRA 
LFT 
TRA 
TRA 



IOXSLL 

IOXIN 

IOXMD 



PZE 
PZE 
PZE 



I0XS4.4 

2,4 

IOXEF 

18 

IOXER 

1,4 

IOXSLL 

IOXSLL 

IOXND 

• + l 
»«,4 
18 

IOXSLL 
IOXSLL 
1,* 
•-1 
1,4 
IOXIN 
(ACTIV,4 

• • 

IOXIN 
•-1 
IOXIN 

• »,4 
200000 

• • 
100000 

3,4 

0,,IOXSEL 

• * 
*• 



SAVE IR4 

SET EOF EXIT 

SET PERMANENT REDUNDANCY EXIT 

GET FIRST WORD OF CALL SEQUENCE 

SAVE MODE FOR SELECT 

SAVE PREFIX FOR SELECT TYPE 

PUT LOC IN ACTIVE CALLING SEQUENCE 

SET TO PICK UP UCB 

-L(UCB) 

I/O COMMANDS IOC TO ADDRESS 

PUT IN SELECT WORD 

GET SELECT WORD 

TEST FOR OTHER USE OF THIS UNIT 

WAIT TILL UNIT FREE 

SIGNED CONTROL WORD TO UCB WORD 2 

SET IN-OPERATION WORD ON 

GO TO ACTIVATE 

UNIT 

TEST FOR REQUEST COMPLETE 

NOT DONE, WAIT 

PICK UP COMPLETION BITS SET BY IOXSEL- 

SET FOR EXIT 

TEST EOF, EOT 

EOF EXIT 

TEST FOR PERM. REDUNDANCY 

YES, ERROR EXIT 

NORMAL RETURN 

LOCATION OF SELECT ROUTINE 
IN OPERATION CELL 
MODE SWITCH 



IOXSEL ROUTINE ENTERED TWICE BY IOEX FOR EACH I/O OPERATION 



IOXSEL 



I0XSS4 
IOXWR 

IOXPST 



SXA 

PAC 

TMI 

CLA 

PDX 

CLA 

STA» 

STT 

NZT 

TXI 

TMI 

SXA 

RDS 

XEC» 

AXT 

TRA 

SXA 

WRS 

TRA 

STI 

STL 

STZ 

TRA 



I0XSS4.4 

0,4 

IOXPST 

0,4 

0,2 

1,4 

(RCHXI 

IOXMD 

IOXMD 

•+1,2,16 

IOXWR 

»+l,2 

• » 

(RCHXI 
«»,4 
1,4 

• + 1,2 

• » 

I0XSS4-1 
IOXIN 
IOXIN 
1,4 
I0XSS4 



SAVE IR 4 

-L(UCB) 

SELECT MINUS OR POSTING ENTRY 

UCB WORD 1 

UNIT TO IR 2 

UCB WORD 2 

STORE LOC TO RCHX 

SAVE MODE FLAG 

TEST MODE 

SET BINARY MODE FOR UNIT 

WRITE 

PLACE READ SELECT ADDRESS 

READ SELECT 

ISSUE RESET LOAD CHANNEL 

RESTORE IR 4 

AND EXIT IOXSEL 

PLACE SELECT ADDRESS FOR WRITE 

WRITE SELECT 

GO TO ISSUE CHANNEL COMMANDS 

POSTING ENTRY SAVE ERROR FLAGS 

SET IN-OPERATION WORD OFF 

SET UCB WORD 2 ZERO 

GO TO EXIT 
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Appendix C: Bit Assignments of 7631 Sense Data Words 



SNSDTA 





Byte 


1 










2 












3 












4 












5 












6 










A 




B 


C 


D 




E 




F 


G 


H 




1 




J 


K 


L 




M 




N 


O 


P 




Q 




R 


S 


T 




U 




V 


W 


X 











































































SNSDTA+1 





Byte 


7 










8 












9 












10 










1 


1 










12 
















A 


B 




C 




D 
























































Y 




Z 


A 


B 




c 




D 































































































































§11 


Assignment 


Comment 


A 


Not Used 


Summary Bits 


B 


Program Check 




C 


Data Check 




D 


Exceptional Condition 




E 


Invalid Sequence 


Program Check 


F 


Invalid Code 




G 


Format Check 




H 


No Record Found 




1 


Invalid Address 


Program Check for CE Track 


J 


Response Check 


Data Check 


K 


Data Compare Check 




L 


Parity or Cyclic Code Check 




M 


Access Inoperative 


Exceptional Condition 


N 


Access Not Ready 




O 


Disk/Drum Circuit Check 




P 


Control Unit Circuit Check 




Q 


Channel Interrupt 




R 


Six-Bit Mode 




S 


Reserved 




T 


Reserved 




U 


ACC-MOD 00 


Attention 


V 


ACC-MOD 01 




W 


ACC-MOD 02 




X 


ACC-MOD 03 




Y 


ACC-MOD 04 




Z 


ACC-MOD 05 




AA 


ACC-MOD 06 




BB 


ACC-MOD 07 




CC 


ACC-MOD 08 




DD 


ACC-MOD 09 
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Appendix D: Bit Assignments of 7640 Sense Data Words 



SNSDTA 
Byte 1 










2 












3 












4 












5 












6 










A 




B 


C 


D 




E 




F 


G 


H 




1 




J 


K 


L 




M 




N 


O 


P 




Q 




R 


S 


T 




U 




V 


W 


X 











































































SNSDTA+1 



Byte 


7 












8 












9 












10 










11 












12 
















A 


B 




C 




D 


E 


F 




G 




H 


1 


J 




K 




L 


M 


N 




O 




P 


Q 


R 
















Y 




Z 


A 


B 




C 




D 


E 


F 




G 




H 


1 


J 




K 




L 


MN 




O 




P 


Q 


R 























































































Bit 


Assignment 


A 


Operator Required 


B 


Program Check 


C 


Data Check 


D 


Exceptional Condition 


E 


X 


F 


X 


G 


X 


H 


X 


1 


Drive Not Ready 


J 


Drive Not Loaded 


K 


Drive File Protected 


L 


Not Used 


M 


Invalid Order 


N 


Drive Busy 


O 


Drive at BOT 


P 


Drive at EOT 


Q 


Correction Occurred 


R 


Parity Check 


S 


Code Check 


T 


Envelope Check 


U 


Overrun Check 


V 


Excessive Skew Check 


W 


Track Start Check 


X 


Not Used 


Y 


Read a Tape Mark 


Z 


Drive in EWA 


AA 


No Data Transmitted 


BB 


Not Used 


CC 


Read Section Busy 


DD 


Write Section Busy 


EE 


Backward Mode 


FF 


Not Used 


GG 


Drive 


HH 


Drive 1 


II 


Drive 2 


JJ 


Drive 3 


KK 


Drive 4 


LL 


Drive 5 


MM 


Drive 6 


NN 


Drive 7 


OO 


Drive 8 


PP 


Drive 9 


QQ 


Not Used 


RR 


Not Used 



Comment 
Summary Bits 



Selected Tape 
Drive Number 
(E + G = Drive 0) 

Operator Required 
Program Check 



Data Check 



Exceptional Condition 



Appendixes 83 



Appendix E: Sample Scatter-Read Program (Disk) 

THE FOLLOWING EXAMPLE IS SOLELY FOR THE PURPOSE OF ILLUSTRATION. 
IT DOES NOT REFLECT BUFFER TECHNIQUES IN USE OF 7909 CHANNEL. 

• SAMPLE ROUTINE PERFORM SCATTER-READ FROM DISK USING IOEX 



START 



LAC 


SYSLBl 


1 


CLA 


SYSTCH 




STO 


FLAG 




ARS 


18 




ZET 


ltl 




TRA 


*-l 




STA 


3,1 




CLS 


2,1 




STO 


2,1 




TSX 


IACTIV 


4 


PZE 


SYSLBl 





UCB 2 CONTENTS ARE ZERO. 
PRIORITY PENDING. 



-L(UCB) TO IR1. 

SEEK LOCATION NEXT RECORD. 

SAVE IT IN FLAG. 



UCB 2 FREE... 
NO, WAIT. 
PLACE IN UCB 4 
SET AF FLAG SO 



FOR IOEX TO DO SEEK. 
IOEX MILL SEEK. 



PERFORM SEEK WHILE SETTING 
UP ORDER, ETC. 



A SEEK REQUEST MAY BE PLACED WITHOUT 



AA 



CLA 



FLAG 



TSX 


(DECV0.4 


LAC 


SYSLBl, 4 


TSX 


(FDAMT.2 


BCI 


1.0CBM06 


PZE 


DVTA 


CLA 


9I0SL 


STO 


1,1 


TSX 


(ACTIV.4 


MZE 


SYSLBl 


ZET 


1,1 


TRA 


•-1 


LDI 


9I0SLI 


LFT 


001000 


TRA 


(PAWSX 


CLA 


FLAG 


TMI 


SYSTRA 


PDX 


0,4 


PXA 


0,4 


LRS 


35 


DVP 


= 40 


TNZ 


AA 


PXA 


0,4 


TRA 


A + 2 


• CONSTANTS 




9I0SL PZE 


CTLR,,9SL 


FLAG PZE 




DVTA DVTA 


» , , 


9I0SLI PZE 




• ONE PURPOSE 


IOEX TYPE SELE 


9SL TRA 


SE 


PZE 


•+1..1 


OCT 


062001000000 


• ERROR PROCEDURE EXCLUDED. 


• BITS FOR ERROR INTERRUPTS. 


SE PAC 


0,2 


TMI 


SM 


CLA 


1,2 


STA« 


(RCHXI 


CLA 


9SL+1 


SLW* 


(RCTXI 


XEC» 


(RCHXI 


TRA 


1,4 


SM STZ 


1,2 


STI 


9I0SLI 



PICK UP CURRENT SEEK A/0 VERIFY 

BINARY ADDRESS. 

CONVERT ADDRESS TO BCD 

-L(UCB) TO IR4. 

BYTES 3-6 OF MQ, TTTT IN BCD. 

HA2 IDENTIFIER IS BM. 

LOCATION OF ORDER TO BE COMPOSED. 

SET UCB 2 PRIORITY. 

PERFORM READ.- 

WAIT TILL DONE. 

7909 CONDITION PLACED BY (SEL-). 

WAS IT UNUSUAL END.. . 

YES. READ IOEX COMMENTS ON PRINTER. 

GO TO ERROR PAUSE. 

NO. MORE OF THIS IBSYS RECORD... 

NO. GO TO IBSYS CONTROL. 

PICK UP NEXT SEEK ADDRESS. 

DOES NEXT TRACK IN BINARY REQUIRE 

A SEEK... 

NO. SEEK NOT NEEDED UNLESS 

REMAINDER IS ZERO. 

YES. SET PRIORITY FOR SEEK TO IOEX. 



PRIORITY WORD UCB 2. 



VERIFY ORDER COMPOSED BY {FDAMT. 
IOEX GIVEN 7909/7631 STATUS 



TRA 



• 7909 PROGRAM 



1,4 



ROUTINE 



EXCLUSION WORD ADORE SS, , COUNT. 
EXCLUSION MASK BITS. 
STATUS RESET ON MATCHED EXCLUSION 

-L(UCB). 

SELECT MINUS. 

UCB2. 

SET RSCX ADDRESS, VIA IRl. 

SET EXCLUSION WORD (OPTIONAL). 

(OPTIONAL). 

RESET AND START CHANNEL. 

EXIT TO IOEX. 

RESET PRIORITY WORD FOR THIS ACCESS. 

SAVE 7909/7631 STATUS. ALL ERRORS 

ARE INDICATED BY IOEX EVEN IF 

EXCLUSION FLAGS ARE USED. 

EXIT TO IOEX. 



CTLR SMS» AA+4 INHIBIT ATTN AND SELECT INTERFACE 

DVTA AND SET READ STATUS. 
FIRST WORD OF A TRACK. ITS 
DECREMENT USED BY CPU PROGRAM. 
SIMULATE SCATTER-LOAD FROM 
TAPE ON DISK. 
PROGRAM NOT TERMINATED BY TWT BECAUSE A TRAP WILL OCCUR DUE 
TO 7909 SEQUENCE ERROR CONDITION, WHEN A CPYD IS LOADED INTO 
WORD CTLR+4. 



SMS» 


AA+4 




CTLR 


DVTA 




CPYP 


FLAG, 


,1 


CPYP 


•*lt , 


1 


WTR 


• 




TCH 


• -2 





84 



Appendix F: Use of Input/Output Units 



IBSYS Operating System 

The symbolic unit-reference structure of the 7090/ 
7094 ibsys Operating System is intended to allow the 
installation more flexibility in the use of the available 
input/output units. Certain input/output units are as- 
signed to System Unit functions, and the remainder 
are made available for use by object programs. In the 
charts that follow, the term "Disk" refers to ibm 1301 
and 2302 Disk Storage Units. The following chart 
shows the over-all requirements of the 7090/7094 ibsys 
Operating System: 

SYSTEM UNIT FUNCTION REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
System Library Unit Yes X X X X 

( SYSLB1 ) 

System Input Unit Yes X X X 

(SYSIN1) 

System Output Unit Yes X X 

(SYSOU1) 

System Peripheral Punch Yes X X 

( SYSPP1 ) 

System Card Reader Optional X 

(SYSCRD) 

System Printer Yes X 

(SYSPRT) 

System Utility Units 1-4 Yes X X X X 

(SYSUT1-4) 

System Utility Units 5-9 No X X X X 

(SYSUT5-9) 

System Checkpoint Units 1-2 No X X X X 

(SYSCK1-2) 

The use of cylinders of a direct access storage unit as one of the 
system units requires a 7631 File Control with the cylinder- 
mode feature. 



IBJOB Processor 

The following chart specifies the input/output unit 
requirements of the ibjob Processor: 

SYSTEM UNIT FUNCTION REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
System Library Unit Yes X X X X 

(SYSLB1) 

System Input Unit Yes XX X 

(SYSIN1) 

System Output Unit Yes X X 

(SYSOU1) 

System Peripheral Punch Yes X X 

( SYSPP1 ) 

System Card Reader Optional X 

(SYSCRD) 

System Printer Yes X 

(SYSPRT) 

System Utility Units 1-4 Yes X X X X 

(SYSUT1-4) 



SYSTEM UNIT FUNCTION REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
System Utility Units 5-9 No X X X X 

(SYSUT5-9) 

System Checkpoint Unit 1 No X X X X 

(SYSCK1) 

System Checkpoint Unit 2 * X X X X 

(SYSCK2) 

The System Checkpoint Unit 2 ( SYSCK2 ) is required if load- 
time debugging is requested. 

Symbolic Update Program 

The following chart specifies the input/output unit 
requirements of the Symbolic Update Program: 

SYSTEM UNIT FUNCTION REQUIRED CAN BE.' 

729 7340 Disk 711 716 7320 
System Library Unit Yes XX X 

(SYSLB1) 
System Input Unit Yes X 

(SYSIN1) 

System Output Unit Yes X 

(SYSOU1) 

System Peripheral Punch No 

(SYSPP1) 

System Card Reader No 

( SYSCRD ) 

System Printer Yes X 

(SYSPRT) 

System Utility Units 1-4 * X 

(SYSUT1-4) 

System Utility Units 5-9 ** 

(SYSUT5-9) 

System Checkpoint Units 1-2 * X 
(SYSCK1-2) 
*Any two of these units are required as Update Input and 
Update Output units. 
** Cannot be referenced. 

Disk /Drum Utilities 

The following chart specifies the input/output unit 
requirements of the Disk/Drum Utilities: 

SYSTEM UNIT FUNCTION REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
System Library Unit Yes XXX X 

(SYSLB1) 

System Input Unit Yes X X X 

(SYSIN1) 

System Output Unit No X X 

(SYSOU1) 

System Peripheral Punch No 

( SYSPP1 ) 

System Card Reader No 

( SYSCRD ) 

System Printer Yes X 

(SYSPRT) 
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SYSTEM UNIT FUNCTION 



REQUIRED 



SYSTEM UNIT FUNCTION 



System Utility Units 1-9 

(SYSUT1-9) 

System Checkpoint Units 1-2 

(SYSCK1-2) 



No 



729 7340 Disk 711 716 7320 
XXX X 



No X X X 



9PAC Processor 

The following chart specifies the input/output unit 
requirements of the 9pac Processor: 

SYSTEM UNIT FUNCTION REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
System Library Unit Yes X X X 

(SYSLB1) 

System Input Unit Yes X 

(SYSIN1) 

System Output Unit Yes X 

(SYSOU1) 

System Peripheral Punch * X 

( SYSPP1 ) 

System Card Reader Yes X 

(SYSCRD) 

System Printer Yes X 

(SYSPRT) 

System Utility Unit 1 No 

( SYSUT1 ) 

System Utility Units 2-4 ** X 

(SYSUT2-4) 

System Utility Units 5-9 * * * 

(SYSUT5-9) 

The System Peripheral Punch is required only when the 
programmer requests a binary deck. 
** System Utility Units 2, 3, and 4 may or may not be required, 
depending on the kind of application. The programmer 
should inform the operator of the utility units that will be 
required. 
***Cannot be referenced. 

Commercial Translator Processor 

The following chart specifies the input/output unit 
requirements of the Commercial Translator Processor: 

SYSTEM UNIT FUNCTION REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 

System Library Unit Yes X X X 

( SYSLB1 ) 

System Input Unit Yes X 

(SYSIN1) 

System Output Unit Yes X 

(SYSOU1) 

System Peripheral Punch Yes X 

(SYSPP1) 

System Card Reader Yes X 

(SYSCRD) 

System Printer Yes X 

(SYSPRT) 

System Utility Unit 1 Yes X 

( SYSUT1 ) 

System Utility Unit 2 Yes X 

(SYSUT2) 

System Utility Unit 3 * X 

(SYSUT3) 



REQUIRED CAN BE : 

729 7340 Disk 711 716 7320 

No 



System Utility Unit 4 

(SYSUT4) 

System Utility Units 5-9 ** 

(SYSUT5-9) 

*System Utility Unit 3 is used as an overflow unit, and may not 
be used for short programs. 
**Cannot be referenced. 

Generalized Sorting System 

The following chart specifies the input/output unit 
requirements of the Generalized Sorting System: 



SYSTEM UNIT FUNCTION 



REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
Yes X X X 



System Library Unit 

(SYSLB1) 

System Input Unit Yes XX X 

(SYSIN1) 

System Output Unit Optional X X 

(SYSOU1) 

System Peripheral Punch No 

(SYSPP1) 

System Card Reader Optional X 

(SYSCRD) 

System Printer Yes X 

(SYSPRT) 

At least four tape units * XX 

System Utility Units 1-4 ** X X 

(SYSUT1-4) 

System Utility Units 5-9 *** 

(SYSUT5-9) 

System Checkpoint Unit 1 *** 

( SYSCK1 ) 

Sys Checkpoint Unit 2 Optional X 

(SYSCK2) 

*At least two tape units on each of two channels. 
**System Utility Units 1-4 may be used as any of the four 
required tape units as specified by Sort Control cards. 
***Cannot be referenced. 

Input/Output Control System 

The following chart specifies the input/output unit 
requirements of the Input/Output Control System: 



SYSTEM UNIT FUNCTION 

System Library Unit 
( SYSLB1 ) 

System Input Unit 

(SYSIN1) 

System Output Unit 
( SYSOU1 ) 

System Peripheral Punch 
( SYSPP1 ) 

System Card Reader 

(SYSCRD) 

System Printer 

(SYSPRT) 

System Utility Units 1-3 

(SYSUT1-3) 



REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
Yes X X X X 



Yes X X 



Yes X 



No X 



No 



X 



X 



Yes 



No X X X 



X 
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SYSTEM UNIT FUNCTION REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
System Utility Unit 4 Yes X X X X 

(SYSUT4) 

System Utility Units 5-9 * 

(SYSUT5-9) 

System Checkpoint Units 1-2 No X X X X 

(SYSCK1-2) 

*Cannot be referenced. 

NOTE: The Restart Program's input/output requirements are 
the same as those for the Input/Output Control System. 



FORTRAN II Processor 

The following chart specifies the input/output unit 
requirements of the Fortran ii Processor: 



SYSTEM UNIT FUNCTION REQUIRED 



CAN be: 
729 7340 Disk 711 716 7320 



System Library Unit Yes X 

(SYSLB1) 

System' Input Unit Yes X 

(SYSIN1) 

System Output Unit Yes X 

(SYSOU1) 

System Peripheral Punch Yes X 

( SYSPP1 ) 

System Card Reader.- No 

(SYSCRD) 

System Printer Yes 

(SYSPRT) 

System Utility Units 1-4 Yes X 

(SYSUT1-4) 

System Utility Units 5-9 * 

(SYSUT5-9) 

System Checkpoint Unit 1 ♦♦ X 

(SYSCK1) 



SYSTEM UNIT FUNCTION REQUIRED CAN BE: 

729 7340 Disk 711 716 7320 
System Checkpoint Unit 2 No X 

(SYSCK2) 

*Cannot be referenced. 
♦♦Required if the SNAPSHOT feature of IOP is utilized. 

System Editor 

The following chart specifies the input/output unit 
requirements for the System Editor: 



SYSTEM UNIT FUNCTION 



REQUIRED 



729 7340 1301 711 716 7320 



Yes X X 



Yes X X 



No X X 



X 



No 



Yes 



X 



Yes X X 



System Library Unit 
(SYSLB1) 
System Input Unit 
(SYSIN1) 

System Output Unit Optional X X 

(SYSOU1) 

System Peripheral Punch 
(SYSPP1) 

System Card Reader 
(SYSCRD) 
System Printer 
(SYSPRT) 
System Utility Unit 1 
(SYSUT1) 
System Utility Unit 2 
(SYSUT2) 
System Utility Unit 3 
(SYSUT3) 

System Utility Units 4-9 
(SYSUT4-9) 

System Checkpoint Units 1-2 No X X X X 

(SYSCK1-2) 
♦Required if alteration cards are not on SYSIN1. 
♦♦Required for creating split systems using the SYS ALT option. 
NOTE: A second System Library Unit (SYSLB2) is required 
if editing from an alternate unit is specified. 



XXX 



X X 



No X X X 



X 



X 



X 
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Appendix G. System Monitor and System Editor Messages 



This appendix lists in alphabetical order the error mes- 
sages that are printed by the System Monitor and Sys- 
tem Editor. An asterisk ( * ) to the right of a message 
indicates that the message is printed on- and off-line. 
Additional information on the System Monitor mes- 
sages can be found in the publication IBM 7090/7094 
IBSYS Operating System; Version 13: Operator's Guide, 
Form C28-6355. 



System Monitor Messages 

CONTROL CARDS NEEDED IN CARD READER 

OPER. ACTION PAUSE 

Explanation: The System Monitor has detected the end- 
of-file condition in the card reader while attempting to 
read a control card. 

1EOR MOUNT NEW SYSOU1 * 

OPER. ACTION PAUSE 

Explanation: The program has written over the end-of- 
reel reflective spot on the System Output Unit. 

ILLEGAL SYSUN1 DEFINITION * 

PROVIDE CLARIFICATION IN CARD READER 

OPER. ACTION PAUSE 

Explanation: One of the following conditions has oc- 
curred: 

1. The system unit specified on either a $RELEASE 
or $AS card cannot be found in the System Unit Name 
Table. 

2. The starting cylinder or number of cylinders speci- 
fied on a $AS card contains a nonnumeric character. 

3. One or both of the system units specified on a 
$SWITCH card cannot be found in the System Unit 
Name Table. 

4. The system unit specified on a $RE WIND, $END- 
FILE, $REMOVE, $PROTECT, or $UNLOAD card 
cannot be found in the System Unit Name Table. 

ILLEGAL UNIT SPECIFIED * 

PROVIDE CLARIFICATION IN CARD READER 

OPER. ACTION PAUSE 

Explanation: The control card printed on-line before the 
message is a $ATTACH or $DETACH card with an in- 
valid unit specification in the variable field. 

ILL UNIT REQ'ST AT xxxxx 

Explanation: A calling sequence to IOEX from octal 
location xxxxx has requested an operation on an invalid 
unit. 

jINTF CK) 

|SEQ CK } 

PRES START TO GO ON 

Explanation: An interface check (INTF CK) or a se- 
quence check (SEQ CK) on a 7909 data channel has 
been detected. 

I/O CK 

PRES STRT TO GO ON 

Explanation: An input/output check on 7807 or 7909 

data channel has been detected. 

xxxxxx NO ASSIGNMENT MADE * 

PROVIDE CLARIFICATION IN CARD READER 
OPER. ACTION PAUSE 



Explanation: One of the following conditions has oc- 
curred: 

1. The library unit on which the System Monitor ex- 
pected to find a particular subsystem is unassigned. 

2. The unit from which the System Monitor should 
read control cards (according to the setting of sense 
switch 1 ) is unassigned. 

NO SYSIN1 EITHER 

Explanation: The System Input Unit has not been as- 
signed. This message is issued in conjunction with the 
message SYSCRD NO ASSIGNMENT MADE S.S.I 
SETTING IGNORED 

NOT A BASIC MONITOR CONTROL CARD * 

PUSH START TO INGORE OR 

PROVIDE CLARIFICATION IN CARD READER 

OPER. ACTION PAUSE 

Explanation: The System Monitor has read a control card 
that it cannot recognize. The control card itself is printed 
just before the message. 

OUTPUT END OF REEL 

Explanation: The end-of-reel reflective spot has been 
encountered on the output tape. 

$RESTART IGNORED-ABSOLUTE VALUE OF COUNT* 
TOO LARGE 

PROVIDE CLARIFICATION IN CARD READER 

OPER. ACTION PAUSE 

Explanation: One of the following conditions has oc- 
curred: 

1. If a $RESTART +n card has been used, this mes- 
sage indicates that a $STOP card was encountered before 
the system had spaced forward n jobs. 

2. If a $RESTART -n card has been used, this mes- 
sage indicates that the beginning-of-tape marker was en- 
countered before the system had backspaced n jobs. 

$RESTART IGNORED-ILLEGAL FIELD * 

PROVIDE CLARIFICATION IN CARD READER 
OPER. ACTON PAUSE 

Explanation: The System Monitor has read a $RESTART 
card with an invalid character in the variable field. 

$RESTART IGNORED-NO MATCH FOUND * 

PROVIDE CLARIFICATION IN CARD READER 
OPER. ACTION PAUSE 

Explanation: There is no $JOB card on the System Input 
Unit with an identification that corresponds to that of 
the $JOB card that follows the $RESTART MATCH 
card just read. 

SPILL TAPE READ ERROR 

Explanation: A read error has occurred on the overflow 
tape, but the dump will proceed without a halt to ensure 
at least a partial recovery of the contents of core storage 
and to allow the system to continue. If this procedure 
is not satisfactory for a particular application, the job 
should be rerun. 

SYSCRD NO ASSIGNMENT MADE 

S.S.I SETTING IGNORED 

Explanation: The card reader is unassigned. An auto- 
matic switch to the System Input Unit is made. 

SYSLBx NOT TAPE (LB1 IS) -CANT $EXECUTE * 

Explanation: The $EXECUTE card has requested a sub- 
system on an alternate library unit ( SYSLBx ) . If this 
is a disk or drum unit and if IBSYS resides on tape, 
this request is invalid. 
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SYSOU1 IS NOT ASSIGNED. NO DUMP CAN * 
BE TAKEN 

Explanation: The System Output Unit has not been as- 
signed; therefore, a dump cannot be taken at this time. 

SYSPP2 IS NOT ASSIGNED, NO DUMP CAN * 
BE TAKEN 

Explanation: The System Peripheral Punch has not been 
assigned; therefore, a dump cannot be taken. 

SYSPP2 IS NOT 729 OR HYPER. NO DUMP CAN BE * 
TAKEN 

Explanation: The alternate System Peripheral Punch is 
neither a 729 Magnetic Tape Unit nor a 7340 Hypertape 
Drive; therefore, a dump cannot be taken at this time. 

xxxxxx UNKNOWN SYSTEM * 

PROVIDE CLARIFICATION IN CARD READER 
OPER. ACTION PAUSE 

Explanation: The $EXECUTE card that is printed be- 
fore this message specified a program that the System 
Monitor could not find on the System Library Unit. 

UNIT xx yyyy ERROR 

nil m 2 m s . . . m24 

Explanation: A read or write error has occurred on the 
Hypertape drive with the symbolic address xx. The sym- 
bolic address is the same as that used on the $ATTAGH 
card. The letters yyyy are either READ or WRITE. The 
m n are 24 octal characters of sense data received from 
the file control. There is no pause associated with this 
message. 

UNIT xx yyy ERROR-TRK OOzzzz 

mi m 2 m s . . . mat 

Explanation: A read or write error has occurred on the 
disk or drum unit with symbolic address xx. The sym- 
bolic address is the same as that used on the $ATTAGH 
card. The letters yyyy are either READ or WRITE. The 
letters zzzz stand for the track address of the last seek 
performed by IOEX. The m n are 24 octal characters 
of sense data received from the file control. There is no 
pause associated with this message. 

( NTRDY / 
UNIT xx 1 NTLOD > 
( FILPR ) 
OPER. ACTION PAUSE 

Explanation: The condition specified prevents the pro- 
gram from reading or writing with the specified Hyper- 
tape drive. The symbols are as follows: 

1. NTRDY — Hypertape drive xx is not ready. 

2. NTLOD — Hypertape drive xx is not loaded. 

3. FILPR — Hypertape drive xx is file protected. 

UNIT xx REC. yyyyy FILE zzzzz 25 ERASES ON WRITE 
Explanation: The program has tried to write record 
yyyyy in file zzzzz on unit xx, and has failed 26 times. 

UNIT xx REC. yyyyy FILE zzzzz - NOISE ON ERASE 

Explanation: An error occurred while the program was 
trying to erase an area of magnetic tape. 

UNIT xx REC. yyyyy FILE zzzzz PERM. READ REDUN. 
Explanation: An uncorrectable error occurred in reading 
record yyyyy of file zzzzz from unit xx. 

UNIT xx REC. yyyyy FILE zzzzz REC. DISCRDED-NOISE 
Explanation: Record number yyyyy in file number zzzzz 
on unit xx has been discarded because it was a noise 
record. 

UNIT xx REC. yyyyy FILE zzzzz WROTE SHORT REC 

Explanation: Record yyyyy of file zzzzz on unit xx is 
less than three words in length and will therefore be 
indistinguishable from a noise record when it is read. 



UNIT xx SEEK UN END 

PRES STRT TO GO ON 

Explanation: An unusual ending has resulted from a 
search (SEEK) of the disk or drum unit with symbolic 
address xx. 

System Editor Messages 

A SYSUN1 IS MISSING. OPERATION 

CARDS NOT PUNCHED 

Explanation: The requested HYPERTAPE or DISK 
LOAD card cannot be punched because neither the 
card punch nor the System Peripheral Punch is assigned. 
Edit is completed. 

CARD COUNT ERROR-GIVEN COUNT 

xxxxxx ACTUAL xxxxxx 

Explanation: The number appearing on the * CHECK 
card does not correspond to the actual number of modi- 
fication cards. 

CHANGE CARD xxxxxx-BINARY CARD 

OUT OF ORDER! 

Explanation: An editor control card or end-of-file was 
expected at this point. The xxxxxx is the card sequence 
number. 

CHANGE CARD xxxxxx-CHECKSUM ERROR * 

EDITING CONTINUES 

Explanation: The checksum appearing on a column 
binary alteration card does not match the one compared 
by the Editor. The xxxxxx is the card sequence number. 

CHANGE CARD xxxxxx-INCORRECT 
EDITOR CONTROL CARDf 

Explanation: Self-explanatory. The xxxxxx is the card 

sequence number. 

EDITING BYPASSED-ERROR IN * 
PREVIOUS JOB SEGMENT 

Explanation: Self-explanatory. 

EDITING BYPASSED xxxxxx UNUSED * 

MODIFICATION CARDS 

Explanation: This message follows one or more diag- 
nostics indicating the type of error that caused the edit 
to be discontinued. 

EDITING CONTINUES AFTER PERM. 

ERROR 729/1301 

Explanation: A redundancy was encountered when read- 
ing from System Library Unit 1 or System Library 
Unit 2. 

EDITING NOT COMPLETED BECAUSE * 
OF ERROR 

Explanation: This message is written in conjunction 
with the messages that are marked with a f. 

EDITING IS DISCONTINUED DUE TO 

UNRECOVERABLE ERROR AT xxxxx 

Explanation: An error has occurred while reading or 
writing disk. The xxxxx is the track number associated 
with the error. 

EDITOR HAS DETECTED AN ERROR IN 

ORDER OF FILES 

Explanation: This message is provided at the completion 
of an edit in which the diagnostic "THE xxxxxx SYS- 
TEMS POSITION DOES NOT AGREE WITH THE 
SYSNAM TABLE" has been issued. 
NOTE: This message is printed off-line. 

END OF TAPE WHILE WRITING SYSTEM 
TAPEf 

Explanation: Self-explanatory. 



fThis message is written in conjunction with the message EDITING NOT 
COMPLETED BECAUSE OF ERROR 
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EOT ON SYSOU1. NEW OUTPUT TAPE 
NEEDED 

Explanation: Self-explanatory. 

ERROR ... IF SYSTEM ON DISK, IBSYS 

MUST BE ON DISK TOOt 

Explanation: One of the following conditions has oc- 
curred. 

1. System Library Unit 1 must be on disk if System 
Library Unit 2 is on disk (in a System Library Unit 2 
edit). 

2. System Utility Unit 1 must be on disk if System 
Utility Unit 3 is on disk (in an edit in which SYSALT 
is specified). 

ERROR IN I/O UNIT* 

Explanation: System Input Unit or System Output Unit 
is assigned as disk or drum. 

ERROR . . . RECORD NAME NOT FOUND IN 

SYSTEM NAME TABLE t 

Explanation: In a System Library Unit 2 edit, the name 
of the first record on System Library Unit 2 must be 
one of the following: 

1. IBSYS, if SYSLB2 is disk, or 5U0002 (the name 
of the IBSYS Load Tape record), if SYSLB2 is tape. 

2. Any system record name that appears in the Sys- 
tem Name Table. 

FILEOR *PLACE REQUEST TOO LATE. 
CARD IGNORED . . . 

Explanation: The tape has already been spaced past 
the record name or system name specified on a FILE 
*AFTER card or a *PLACE card. 

HYPERTAPE INPUT REDUNDANCY 

Explanation: An I/O check, sequence check, or interface 
check has occurred while reading the System Input Unit 
when the input unit is a 7340 hypertape. 

ILLEGAL EOF RETURN f 

Explanation: A relocatable binary card image was ex- 
pected at this point. 

IMPROPER INSERT CARD, SKIP TO NEXT 
CONT. CARD 

Explanation: The second parameter on an ""INSERT 
card is not SYSALT. Editing continues at the next 
control card. 

IMPROPER $ BINARY CONTROL * 

CARD SEQUENCE! 

Explanation: A control card in a relocatable binary modi- 
fication deck is out of order. The correct order is: 
$IBLDR, $TEXT, $CDICT, $DKEND. 

INVALID BINARY CARD IN RELOCATABLE 
PROCESSING 

Explanation: Self-explanatory. 

INVESTIGATE CHANNEL TROUBLE. START 

Explanation: An I/O check, sequence check, or inter- 
face check has occurred while reading or writing disk 
or hypertape. 



MODIFICATION FILE REDUNDANCY 

Explanation: A redundancy has been encountered during 
reading of the modification file on System Utility Unit 2. 

SOME SYSUN1 HAS NO UNITf 

Explanation: The system unit function specified on an 
Editor control card is not assigned. 

SYSALT OPERATION IS NOT ALLOWED 
WITH LB2 EDITf 

Explanation: Self-explanatory. 

SYSLDR DICTIONARY TOO LARGE t 

Explanation: The number of records to be written onto 
disk exceeds the number that can be recorded in the 
System Loader Table. 

SYSUN1 CYL. LIMIT REACHED. SS4 DOWN, 
GO ON. UP, END EDIT 

Explanation: The last cylinder assigned to a system 
unit function has been reached while writing on a disk 
or drum. 

TAPE IDENTIFICATION ERROR, xxxxxx 

WAS CHECK WORD, xxxxxx IS TAPE ID 

Explanation: The tape ID that is specified on the 
*CHECK card does not match that which appears in 
the *EOT record. 

TAPE REDUNDANCY 

Explanation: A redundancy has been encountered dur- 
ing reading of the modifications from the System Input 
Unit. 

THE xxxxxx SYSTEMS POSITION DOES NOT 

AGREE WITH THE SYSNAM TABLE 

Explanation: The record name specified was encoun- 
tered at a point where a system name was expected. 
NOTE: This message is printed off-line. 

UNRECOGNIZED PARAMETER ON *EDIT 
CARD-xxxxxx 

Explanation: Self-explanatory, xxxxxx is the parameter. 

$DKEND CARD MISSINGf * 

Explanation: A control card is missing from a relocatable 
binary modification deck. 

*CHECK CARD VARIABLE FIELD ERROR. 
CARD IGNORED 

Explanation: Self-explanatory. 

*PLACE ERROR. IBSYS POSITION TABLE 

FULL. INSERT IGNORED 

Explanation: There is no room for inserting another 
name in the 50-entry System Name Table. 

*PLACE ERROR. IMPROPER FIELD OR 
REQUEST-CARD IGNORED 

Explanation: Self-explanatory. 



tThis message is written in conjunction with the message EDITING NOT 
COMPLETED BECAUSE OF ERROR 
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When this is necessary, a special modification deck is 
distributed. However, the cards from these special 
decks should not be incorporated in the Cumulative 
Editor Deck. In particular, see the first modification 
letter issued to the ibjob Subroutine Library after the 
release of a new version for details concerning the iblib 
Cumulative Editor Deck. 

The user may keep a copy of the distributed System 
Library Tape as a backup tape and use it and the 
Cumulative Editor Deck whenever it is necessary to 
produce a System Library Tape at the current modi- 
fication level. If a special modification deck is distrib- 
uted, it may be used to produce a new backup System 
Library Tape from the old one. The new backup tape 
and the Cumulative Editor Deck may then be used, 
when necessary, to produce an up-to-date System 
Library Tape. 

Maintaining a Two-Tape System Library 

Some installations may use a two-tape System Library, 
in which parts of the ibjob Processor are located on a 



second System Library Tape. To incorporate ibm 
modifications without changing the distributed mod- 
ification decks, a duplicate of the System Library 
should be maintained on a single tape reel. After mod- 
ifications are incorporated in the single System Library 
Tape, it may be used to produce a two-tape System 
Library, in which parts of the ibjob Processor are lo- 
cated on a second tape. A discussion of the use of 
multiple library units is contained in the publication 
IBM 7090/7094 IBSYS Operating System: IBJOB 
Processor, Form C28-6389. 



7320 Drum Update-Edit Decks for IBJOB 

The 7320 Drum Update-Edit Decks are designed to 
serve as a guide for providing ibjob system residence 
on 7320 Drum Storage. These decks are shown in Fig- 
ures 57 and 58. 

Edit Deck Number 1 splits the ibsys Operating Sys- 
tem, on a 729 Disk/Drum/Hypertape-Capability Sys- 
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Figure 57. 7320 Update-Edit Deck Number 1 
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• Figure 58. 7320 Update-Edit Deck Number 2 



tern Library Tape, between a 7320 drum and a 729 
System Tape. The ibsys System Monitor, the ibjob 
Monitor (minus the ibjob Subroutine Library 
(iblib) ), and the ibsys Editor are edited onto a 
7320 drum, while the ibjob Subroutine Library and 
all other subsystems under the ibsys Operating Sys- 
tem are edited onto a 729 tape. This 729 System Library 
Tape (syslb2) is used in conjunction with those sys- 
tems edited onto the 7320 drum. Edit Deck Number 1 
accomplishes this split of the ibsys Operating System 
with no assembly or reblocking of components required. 



Octal modification cards are included in deck num- 
ber 1 for the ibsys and ibjob records to modify the 
system to do the following: 

1. Attach tape unit ai as syslb2. 

2. Modify the ibjob action table to indicate that 
iblib is on syslbs. 

A one-pass ibedt is performed. During this edit, 
syslbs is created on tape unit A4. A map of the sys- 
tem as it resides on 7320 drum and on a 729 tape is 
written on the system output tape. At the end of the 
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